Операции с внешними IP-адресами

Получить список внешних IP-адресов

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Внешние IP-адреса.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Выполните команду:
bash
```
1
mws vpc external-address list
```

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Выполните запрос:
bash
```
1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses \
2
  -H "Authorization: Bearer <IAM-токен>"
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будет выведены список внешних IP-адресов с детализацией параметров.

Получить информацию о внешнем IP-адресе

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Внешние IP-адреса.
Нажмите на имя нужного IP-адреса.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя внешнего IP-адреса:
bash
```
1
mws vpc external-address list
```

Выполните команду:

1
mws vpc external-address get <имя IP-адреса>

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя внешнего IP-адреса:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:
bash
```
1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses/<имя IP-адреса> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будут выведены параметры IP-адреса с детализацией.

Зарезервировать новый внешний IP-адрес

Веб-консоль
MWS CLI
Terraform
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Внешние IP-адреса.
Нажмите кнопку Зарезервировать.
(опционально) Измените автоматически сгенерированное имя IP-адреса. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) IP-адреса.
(опционально) Выберите Egress NAT.
(опционально) Добавьте описание.
Нажмите кнопку Зарезервировать.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.

Выполните команду:

1
mws vpc external-address create <имя IP-адреса> \
2
  --description <описание IP-адреса>

1
kind: vpc/v1/externalAddress
2
metadata:
3
    createTime: "2025-06-16T03:23:13Z"
4
    etag: ebd84b2579834c3bbee913edb2084e4e
5
    generation: 1
6
    id: projects/<имя проекта>/externalAddresses/<имя IP-адреса>
7
    name: <имя IP-адреса>
8
    updateTime: "2025-06-16T03:23:13Z"
9
    description: "<описание IP-адреса>"
10
spec: {}
11
status:
12
    ipAddress: 10.30.136.44
13
    ready:
14
        state: PROCESSING

Если у вас не установлен Terraform, установите его.
Опишите в конфигурационном файле параметры IP-адреса, который нужно зарезервировать:
hcl
```
1
resource "mws_vpc_external_address" "vm_external_address" {
2
  external_address = "<имя ВМ>-external-address"
3
}
```
Здесь address — идентификатор зарезервированного IP-адреса. Подробнее о параметрах внешних IP-адресов и особенностях их использования см. в спецификации.
Проверьте конфигурационный файл на наличие синтаксических ошибок:
bash
```
1
terraform validate
```
Если ошибок нет, вы получите следующее сообщение:
bash
```
1
Success! The configuration is valid.
```
Выполните команду:
bash
```
1
terraform plan
```
Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.
Примените конфигурацию:
bash
```
1
terraform apply
```
Подтвердите выполнение операций: введите слово yes и нажмите Enter.

Во время создания ресурсов Terraform будет выводить краткие сообщения о выполняемых операциях. Проверить, что ресурсы созданы и настроены корректно, можно в веб-консоли.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Выполните запрос:

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses/<имя IP-адреса> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "metadata":{
6
      "name":"<имя IP-адреса>",
7
      "displayName":"<отображаемое имя IP-адреса>"
8
    },
9
    "spec": {}
10
}'

Если IP-адрес был зарезервирован успешно, вы получите ответ с кодом 200 OK.

Изменить отображаемое имя и описание внешнего IP-адреса

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Внешние IP-адреса.
Нажмите на имя нужного IP-адреса.
Нажмите на значок редактирования для имени или описания и внесите изменения.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя внешнего IP-адреса:
bash
```
1
mws vpc external-address list
```

Выполните команду:

1
mws vpc external-address update <имя IP-адреса> \
2
  --description <новое описание IP-адреса> \
3
  --display-name <новое отображаемое имя IP-адреса>

1
kind: vpc/v1/externalAddress
2
metadata:
3
    createTime: "2025-06-16T03:23:13Z"
4
    description: <новое описание IP-адреса>
5
    etag: d313d5d9a3e94215a8be91c454ffc1bc
6
    generation: 2
7
    id: projects/<имя проекта>/externalAddresses/<имя IP-адреса>
8
    name: <имя IP-адреса>
9
    displayName: <новое отображаемое имя IP-адреса>
10
    updateTime: "2025-06-16T03:27:35Z"
11
spec: {}
12
status:
13
    ipAddress: 10.30.136.44
14
    ready:
15
        state: PROCESSING

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя внешнего IP-адреса:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses/<имя IP-адреса> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
   "metadata":{
6
      "displayName":"<новое отображаемое имя>",
7
      "description":"<новое описание>"
8
   }
9
}'

Если параметры были изменены успешно, вы получите ответ с кодом 200 OK.

Зарезервировать временный внешний IP-адрес

Веб-консоль
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Внешние IP-адреса.
Нажмите на значок ... для нужного временного IP-адреса и выберите Зарезервировать.
Подтвердите резервирование IP-адреса.

Освободить зарезервированный внешний IP-адрес

Внешний IP-адрес нельзя освободить, если он используется другими ресурсами.

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Внешние IP-адреса.
Нажмите на имя нужного зарезервированного IP-адреса.
Нажмите кнопку — и подтвердите освобождение адреса.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя внешнего IP-адреса:
bash
```
1
mws vpc external-address list
```
Выполните команду:
bash
```
1
mws vpc external-address delete <имя IP-адреса>
```
Если IP-адрес был освобожден успешно, на экран будет выведен ответ success.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя внешнего IP-адреса:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X DELETE https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/externalAddresses/<имя IP-адреса> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Если IP-адрес был освобожден успешно, вы получите ответ с кодом 204 No Content.