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

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

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Сети. Откроется список сетей.
Выберите нужную сеть и перейдите на вкладку Подсети. Откроется список подсетей.
Выберите нужную подсеть и перейдите на вкладку IP-адреса.

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

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

1
mws vpc address list --network <имя сети>

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

Узнайте имя сети:

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

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

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

MWS CLI
API

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

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

1
mws vpc address list --network <имя сети>

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

1
mws vpc address get <имя IP-адреса> \
2
  --network <имя сети>

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

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Сети. Откроется список сетей.
Выберите нужную сеть и перейдите на вкладку Подсети. Откроется список подсетей.
Выберите нужную подсеть и перейдите на вкладку IP-адреса.
Нажмите кнопку Зарезервировать.
Укажите параметры IP-адреса:
- (опционально) Имя — измените автоматически сгенерированное имя IP-адреса. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) IP-адреса.
- Подсеть — выберите подсеть, в которой будет зарезервирован IP-адрес.
- IP-адрес — выберите одну из опций:
  - Назначить автоматически — IP-адрес выбирается автоматически из диапазона подсети;
  - Вручную — укажите IP-адрес из диапазона подсети.
(опционально) Задайте настройки DNS:
- FQDN — укажите такое же доменное имя, как для ВМ, если хотите, чтобы оно ассоциировалось с IP-адресом.
- TTL — укажите время жизни DNS-записи в секундах, минутах или часах. Чем меньше значение, тем быстрее изменения распространятся в интернете, но тем чаще серверы будут вынуждены запрашивать данные повторно.
- Задать обратную зону — включите опцию для создания PTR-записи. Это разрешит другим устройствам внутренней сети определять доменное имя вашей ВМ по ее IP-адресу.
(опционально) Добавьте описание.
Нажмите кнопку Зарезервировать.

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

Узнайте имя подсети:

1
mws vpc subnet list --network <имя сети>

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

1
mws vpc address list --network <имя сети>

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

1
mws vpc address create <имя IP-адреса> \
2
  --network <имя сети> \
3
  --subnet <имя подсети>

1
kind: vpc/v1/address
2
metadata:
3
    createTime: "2025-06-05T03:00:29Z"
4
    etag: 9758488e0b414454a794457c5812536b
5
    generation: 1
6
    id: projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>
7
    name: <имя IP-адреса>
8
    updateTime: "2025-06-05T03:00:29Z"
9
spec:
10
    subnet: <имя подсети>
11
status:
12
    ipAddress: 192.168.0.12
13
    ready:
14
        state: PROCESSING

Если у вас не установлен Terraform, установите его.
Опишите в конфигурационном файле параметры IP адреса, который нужно зарезервировать:
hcl
```
1
resource "mws_vpc_address" "vm_primary_network_interface_address" {
2
  network  = "<имя сети>"
3
  subnet   = "<имя подсети>"
4
  address  = "<имя ВМ>-primary-network-interface-address"
5
}
```
Здесь:
- network — ссылка на сеть;
- subnet — ссылка на подсеть;
- 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 GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

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

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

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

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses/<имя 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":"<тип адреса: INTERNAL — внутренний>",
11
      "version":"IPV4"
12
   }
13
}'

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

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

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

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

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

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

1
mws vpc address --network <имя сети> list

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

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

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

1
mws vpc address update --help

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

1
mws vpc address update <имя IP-адреса> \
2
  --network <имя сети> \
3
  --description "<новое описание для внутреннего IP-адреса>"

1
kind: vpc/v1/address
2
metadata:
3
    createTime: "2025-06-05T04:25:48Z"
4
    description: <новое описание для внутреннего IP-адреса>
5
    etag: 71879e12dd244f248ced0d04ebc5c8f7
6
    generation: 2
7
    id: projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>
8
    name: <имя IP-адреса>
9
    updateTime: "2025-06-16T03:33:17Z"
10
spec:
11
    subnet: <имя подсети>
12
status:
13
    ipAddress: 192.168.0.11
14
    ready:
15
        state: PROCESSING

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

Узнайте имя сети:

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

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

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

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

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses/<имя 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-адрес

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Сети. Откроется список сетей.
Выберите нужную сеть и перейдите на вкладку Подсети. Откроется список подсетей.
Выберите нужную подсеть и перейдите на вкладку IP-адреса. Откроется список IP-адресов подсети.
Выберите нужный IP-адрес. Откроется страница IP-адреса.
Нажмите кнопку — и подтвердите освобождение адреса.

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

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

1
mws vpc address list --network <имя сети>

Выполните команду:
bash
```
1
mws vpc address delete <имя внутреннего IP-адреса> --network <имя сети>
```
В случае успешного удаления на экран будет выведен ответ success.

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

Узнайте имя сети:

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

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

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

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

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

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