Метод listSubnets

HTTP-запрос
Path-параметры
Query-параметры
Ответ

Возвращает список доступных подсетей в указанной облачной сети.

HTTP-запрос

GET https://vpc.api.cloud.yandex.net/vpc/v1/networks/{networkId}/subnets

Path-параметры

Параметр	Описание
networkId	Обязательное поле. Идентификатор ресурса Network для получения списка подсетей. Максимальная длина строки в символах — 50.

Query-параметры

Параметр	Описание
pageSize	Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Значение по умолчанию: 100. Максимальное значение — 1000.
pageToken	Токен страницы. Установите значение pageToken равным значению поля nextPageToken прошлого запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.

Параметр

Описание

pageSize

Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Значение по умолчанию: 100. Максимальное значение — 1000.

pageToken

Токен страницы. Установите значение pageToken равным значению поля nextPageToken прошлого запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.

Ответ

HTTP Code: 200 - OK

{
  "subnets": [
    {
      "id": "string",
      "folderId": "string",
      "createdAt": "string",
      "name": "string",
      "description": "string",
      "labels": "object",
      "networkId": "string",
      "zoneId": "string",
      "v4CidrBlocks": [
        "string"
      ],
      "v6CidrBlocks": [
        "string"
      ]
    }
  ],
  "nextPageToken": "string"
}

Поле	Описание
subnets[]	object Ресурс Subnet. Подробнее см. Подсети.
subnets[]. id	string Идентификатор подсети.
subnets[]. folderId	string Идентификатор каталога, которому принадлежит подсеть.
subnets[]. createdAt	string (date-time) Время создания ресурса в формате в RFC3339. Строка в формате RFC3339.
subnets[]. name	string Имя подсети. Имя должно быть уникальным в каталоге. Длина имени должна быть от 3 до 63 символов.
subnets[]. description	string Описание подсети. Длина описания должна быть от 0 до 256 символов.
subnets[]. labels	object Метки ресурса в формате `ключ:значение`. Максимум 64 метки на ресурс.
subnets[]. networkId	string Идентификатор облачной сети, к которой принадлежит подсеть.
subnets[]. zoneId	string Идентификатор зоны доступности, где находится подсеть.
subnets[]. v4CidrBlocks[]	string CIDR. Диапазон внутренних адресов, определенных для этой подсети. Это поле может быть задано только во время создания ресурса Subnet и не может быть изменено. Например, 10.0.0.0/22 или 192.168.0.0/24. Минимальный размер подсети /28, максимальный размер подсети /16.
subnets[]. v6CidrBlocks[]	string IPv6 еще не доступен.
nextPageToken	string Токен для получения следующей страницы результатов в ответе. Если количество результатов больше чем pageSize, используйте nextPageToken в качестве значения параметра pageToken в следующем запросе списка ресурсов. Все последующие запросы будут получать свои значения nextPageToken, для перебора страниц результатов.