Операции с подсетями

Просмотреть информацию о подсетях

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Virtual Private Cloud → Сети.
Выберите нужную сеть и перейдите на вкладку Подсети.
Выберите нужную подсеть.

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

Просмотрите список подсетей для вашей сети:

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

1
+---------------+--------------------+------------+----------------------+
2
|       ID      |    DESCRIPTION     |   STATUS   |      UPDATE TIME     |
3
+---------------+--------------------+------------+----------------------+
4
| <имя подсети> | <описание подсети> | OK         | 2025-05-23T14:32:34Z |
5
+---------------+--------------------+------------+----------------------+

Чтобы получить информацию о конкретной подсети, выполните команду:

1
mws vpc subnet get --network <имя сети> <имя подсети>

1
kind: vpc/v1/subnet
2
metadata:
3
    createTime: "2025-04-22T14:57:55Z"
4
    etag: 3caf27d5a8cf4996b7d3d488c0b22116
5
    generation: 1
6
    id: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
7
    name: <имя подсети>
8
    updateTime: "2025-04-22T14:57:56Z"
9
spec:
10
    cidr: 192.168.0.0/24
11
status:
12
    dhcpOptions:
13
        domainName: <имя проекта>.c.mws
14
        domainNameServers:
15
            - 169.254.169.254
16
    ready:
17
        state: OK

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

Создать подсеть

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Virtual Private Cloud → Сети.
Выберите сеть, в которой нужно создать подсеть.
Перейдите на вкладку Подсети и нажмите кнопку Добавить подсеть.
(опционально) Измените автоматически сгенерированное имя подсети. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) подсети.
(опционально) Добавьте описание.
Укажите диапазон IP-адресов.
(опционально) Откройте секцию настроек DHCP и укажите:
Нажмите кнопку Создать.

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

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

1
mws vpc subnet create <имя подсети> \
2
  --network <имя сети> \
3
  --cidr <CIDR подсети — например, 192.168.0.0/16> \
4
  --dhcp-options-domain-name <доменное имя> \
5
  --dhcp-options-domain-name-servers <IP-адрес DNS-сервера> \
6
  --dhcp-options-ntp-servers <IP-адрес NTP-сервера>

1
kind: vpc/v1/subnet
2
metadata:
3
    createTime: "2025-06-16T04:12:06Z"
4
    etag: ebf00190f30d4f1092f0356f5c6b46b5
5
    generation: 1
6
    id: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
7
    name: <имя подсети>
8
    updateTime: "2025-06-16T04:12:06Z"
9
spec:
10
    cidr: 192.168.0.0/16
11
status:
12
    dhcpOptions:
13
        domainName: cmpt001.c.mws
14
        domainNameServers:
15
            - 169.254.169.254
16
        ntpServers:
17
            - 91.231.182.17
18
    ready:
19
        state: PROCESSING

Если у вас не установлен Terraform, установите его.
Опишите в конфигурационном файле параметры подсети, которую нужно создать:
hcl
```
1
resource "mws_vpc_subnet" "<имя подсети> {
2
  subnet  = "<имя подсети>"
3
  network = "<ссылка на родительскую сеть>"
4
  cidr    = "<СIDR подсети>"
5

6
  dhcp_options = {
7
    domain_name: <DNS-суффикс>
8
    domain_name_servers = [
9
      "<IP-адрес DNS-серверa 1>", <"IP-адрес DNS-сервера 2>"
10
    ]
11
    ntp_servers = [
12
      "<IP-адрес NTP-сервера 1>", "<IP-адрес NTP-сервера 2>"
13
    ]
14
  }
15
}
```
Здесь:
- subnet — имя создаваемой подсети;
- network — ссылка на родительскую сеть;
- cidr — диапазон IP-адресов подсети;
- (опционально) секция dhcp_options — настройки DHCP:
  - domain_name — DNS-суффикс по умолчанию;
  - domain_name_servers — IP-адреса DNS-серверов через запятую;
  - ntp_servers — IP-адреса NTP-серверов через запятую.
Подробнее о параметрах подсетей и особенностях их использования см. в спецификации.
Проверьте конфигурационный файл на наличие синтаксических ошибок:
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/<имя проекта>/networks/<имя сети>/subnets/<имя подсети> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
      "metadata": {
6
        "name": "<имя подсети>",
7
        "displayName": "<отображаемое имя подсети>",
8
        "description": "<описание подсети>"
9
      },
10
      "spec": {
11
        "network": "networks/<имя подсети>",
12
        "cidr": "<CIDR подсети>",
13
        "dhcpOptions": {
14
          "domainName": "<DNS-суффикс>",
15
          "domainNameServers": ["<IP-адрес DNS-cервера 1>", <"IP-адрес DNS cервера 2>"],
16
          "ntpServers": ["<IP-адрес NTP-сервера 1>", "<IP-адрес NTP-cервера 2>"]
17
        }
18
      }
19
    }'

Отредактировать параметры подсети

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Virtual Private Cloud → Сети.
Выберите сеть, в которой нужно отредактировать параметры подсети.
Перейдите на вкладку Подсети.
Нажмите на значок ... для нужной подсети и выберите Редактировать.
Отредактируйте отображаемое имя или описание.
Нажмите кнопку Сохранить.

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

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

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

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

1
mws vpc subnet update --help

Пример изменения подсети:

1
mws vpc subnet update <имя подсети> \
2
  --network <имя сети> \
3
  --description <новое описание подсети>

1
kind: vpc/v1/subnet
2
metadata:
3
    createTime: "2025-06-16T04:12:06Z"
4
    description: <новое описание подсети>
5
    etag: 1856bf421a414dd8ba634dc6085b9064
6
    generation: 2
7
    id: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
8
    name: <имя подсети>
9
    updateTime: "2025-06-16T04:32:13Z"
10
spec:
11
    cidr: 192.168.0.0/16
12
status:
13
    dhcpOptions:
14
        domainName: cmpt001.c.mws
15
        domainNameServers:
16
            - 169.254.169.254
17
    ready:
18
        state: PROCESSING

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

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

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

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

Отредактировать настройки DHCP

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Virtual Private Cloud → Сети.
Выберите сеть, в которой нужно отредактировать параметры подсети.
Перейдите на вкладку Подсети и выберите нужную подсеть.
Нажмите на значок в виде карандаша в блоке Настройки DHCP.
В открывшемся окне укажите собственный DNS-суффикс по умолчанию и IP-адреса собственных DNS-cерверов.
Нажмите кнопку Сохранить.

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

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

1
mws vpc subnet update <имя подсети> \
2
  --network <имя сети> \
3
  --dhcp-options-domain-name <доменное имя> \
4
  --dhcp-options-domain-name-servers <IP-адрес DNS-сервера>

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

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

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{"dhcpOptions":{"domainName":"<собственный DNS-суффикс по умолчанию>","domainNameServers":["<IP-адреса собственных DNS-серверов через запятую>"]}}'

Удалить подсеть

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Virtual Private Cloud → Сети.
Выберите нужную сеть и перейдите на вкладку Подсети.
Нажмите на значок ... для удаляемой подсети и выберите Удалить.
Подтвердите удаление.

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

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

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

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

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