Операции с внешними 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

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

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

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

Зарезервировать статический IP-адрес

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

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

Если у вас нет утилиты 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
      "type":"<тип адреса: EXTERNAL - внешний>",
11
      "version":"IPV4"
12
   }
13
}'

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

Редактировать IP-адрес

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

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

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

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

1
mws vpc external-address update <имя IP-адреса> <набор флагов>

Полный список флагов вы можете получить с помощью команды:

1
mws vpc external-address update --help

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

1
mws vpc external-address update <имя IP-адреса> \
2
  --description <новое описание внешнего 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: test
9
    updateTime: "2025-06-16T03:27:35Z"
10
spec: {}
11
status:
12
    ipAddress: 10.30.136.44
13
    ready:
14
        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-адресов.
Выберите нужный IP-адрес. Откроется страница IP-адреса.
Нажмите кнопку — и подтвердите освобождение адреса.

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