DescribeSubnets#

Description#

Запрос на получение списка всех существующих подсетей в виртуальном частном облаке и их описаний. Возможно применение одного или нескольких фильтров по параметрам частных облаков.

Request Parameters#

  • Filter.N — Параметры фильтрации.

    • Тип: Список объектов Filter

    • Необходимо: Нет

  • VpcId — Идентификатор VPC.

    • Тип: String

    • Необходимо: Нет

Supported Filters#

  • availability-zone — Идентификатор зоны доступности. Вы также можете использовать availabilityZone.

  • available-ip-address-count — Количество доступных IPv4-адресов в подсети.

  • default-for-az — Подсеть по умолчанию или нет. Вы также можете использовать defaultForAz.

  • map-public-ip-on-launch — Указывает, будут ли назначаться внешние IP-адреса экземплярам, созданным в этой подсети. Адреса назначаются только при наличии свободных выделенных Elastic IP-адресов.

  • subnet-id — Идентификатор подсети.

  • tag-key — Ключ тега. Такой фильтр позволяет получить ресурсы с указанным ключом и любым значением.

  • tag:<tag-key> — Пара ключ/значение тега. Ключ тега передаётся в названии фильтра, значение тега — в значении фильтра.

  • vpc-id — Идентификатор частного облака.

Response Elements#

  • requestId — Идентификатор запроса.

    • Тип: String

  • subnetSet — Информация о подсетях.

    • Тип: Список объектов Subnet

Examples#

c2-ec2 DescribeSubnets

c2-ec2 DescribeSubnets VpcId <vpc_id>

c2-ec2 DescribeSubnets Filter.1.Name subnet-id Filter.1.Value.1 <subnet_id>

c2-ec2 DescribeSubnets Filter.1.Name tag:<tag-key> Filter.1.Value <tag-value>

c2-ec2 DescribeSubnets Filter.1.Name tag-key Filter.1.Value <tag-key>