subnet-available

Описание

Ожидание, пока JMESPath-запрос Subnets[].State вернёт значение available для всех элементов при опросе с помощью describe-subnets. Будет происходить опрос каждые 15 секунд до достижения успешного состояния. Команда завершится с кодом возврата 255 после 40 неудачных проверок.

См. также: Документация API AWS

subnet-available — это операция с постраничной навигацией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную навигацию, указав аргумент --no-paginate. При использовании --output text и аргумента --query с ответом с постраничной навигацией, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Subnets

Синтаксис

  subnet-available
[--filters <value>]
[--subnet-ids <value>]
[--dry-run | --no-dry-run]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--filters (список)

Фильтры.

availability-zone — Доступная зона для подсети. Также можно использовать availabilityZone в качестве имени фильтра.
availability-zone-id — Идентификатор доступной зоны для подсети. Также можно использовать availabilityZoneId в качестве имени фильтра.
available-ip-address-count — Количество доступных адресов IPv4 в подсети.
cidr-block — Блок CIDR IPv4 подсети. Указанный вами блок CIDR должен точно соответствовать блоку CIDR подсети для получения информации о подсети. Также можно использовать cidr или cidrBlock в качестве имён фильтров.
customer-owned-ipv4-pool — Пул адресов IPv4, принадлежащий клиенту, связанный с подсетью.
default-for-az — Указывает, является ли данная подсеть стандартной для доступной зоны (true | false). Также можно использовать defaultForAz в качестве имени фильтра.
enable-dns64 — Указывает, должны ли запросы DNS, отправленные к Amazon-предоставленному DNS-резольверу в этой подсети, возвращать синтетические адреса IPv6 для IPv4-только конечных точек.
enable-lni-at-device-index — Указывает позицию устройства для локальных сетевых интерфейсов в этой подсети. Например, 1 указывает, что локальные сетевые интерфейсы в этой подсети являются вторичным сетевым интерфейсом (eth1).
ipv6-cidr-block-association.ipv6-cidr-block — Блок CIDR IPv6, связанный с подсетью.
ipv6-cidr-block-association.association-id — Идентификатор ассоциации для блока CIDR IPv6, связанного с подсетью.
ipv6-cidr-block-association.state — Состояние блока CIDR IPv6, связанного с подсетью.
ipv6-native — Указывает, является ли эта подсеть только IPv6 (true | false).
map-customer-owned-ip-on-launch — Указывает, получает ли сетевой интерфейс, созданный в этой подсети (включая сетевой интерфейс, созданный с помощью RunInstances), адрес IPv4, принадлежащий клиенту.
map-public-ip-on-launch — Указывает, получают ли запущенные в этой подсети экземпляры публичный адрес IPv4.
outpost-arn — Amazon Resource Name (ARN) Outpost.
owner-id — Идентификатор учётной записи Amazon Web Services, владеющей подсетью.
private-dns-name-options-on-launch.hostname-type — Тип имени хоста, который следует назначить экземплярам в подсети при запуске. Для подсетей только IPv4 и двойной стековой (IPv4 и IPv6), имя DNS экземпляра может быть основано на адресе IPv4 экземпляра (ip-имя) или идентификаторе экземпляра (имя ресурса). Для подсетей только IPv6 имя DNS экземпляра должно быть основано на идентификаторе экземпляра (имя ресурса).
private-dns-name-options-on-launch.enable-resource-name-dns-a-record — Указывает, нужно ли отвечать на запросы DNS для имён хостов экземпляров с помощью записей DNS A.
private-dns-name-options-on-launch.enable-resource-name-dns-aaaa-record — Указывает, нужно ли отвечать на запросы DNS для имён хостов экземпляров с помощью записей DNS AAAA.
state — Состояние подсети (pending | available).
subnet-arn — Amazon Resource Name (ARN) подсети.
subnet-id — Идентификатор подсети.
tag — Сочетание ключ/значение тега, назначенного ресурсу. Используйте ключ тега в качестве имени фильтра, а значение тега — в качестве значения фильтра. Например, чтобы найти все ресурсы, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner в качестве имени фильтра и TeamA в качестве значения фильтра.
tag-key — Ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которым назначен тег с определённым ключом, независимо от значения тега.
vpc-id — Идентификатор VPC для подсети.

(структура)

Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по конкретным критериям, таким как теги, атрибуты или идентификаторы.

Если вы указываете несколько фильтров, фильтры объединяются с AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.

Дополнительную информацию см. в разделе «Списки и фильтры с помощью командной строки и API» в руководстве пользователя Amazon EC2.

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

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

(строка)

Сокращённый синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--subnet-ids (список)

Идентификаторы подсетей.

По умолчанию: описывает все ваши подсети.

(строка)

Синтаксис:

"string" "string" ...

--dry-run | --no-dry-run (логическое значение)

Проверяет, есть ли у вас необходимые разрешения для действия, не выполняя фактического запроса, и возвращает ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation. В противном случае — UnauthorizedOperation.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания места начала постраничной навигации. Это значение NextToken из ранее усечённого ответа.

Примеры использования см. в разделе «Постраничная навигация» в руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-службы. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-службы, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймауты вызовов AWS-службы.

Примеры использования см. в разделе «Постраничная навигация» в руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной навигации укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Постраничная навигация» в руководстве пользователя AWS Command Line Interface.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверит входные данные команды и вернёт пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Общие параметры

--debug (boolean)

Включить отладку логирования.

--endpoint-url (string)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию по проверке SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команд.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать конкретный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/среды.

--version (string)

Показать версию этого инструмента.

--color (string)

Включить/выключить вывод в цвете.

on
off
auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения к сокету в секундах. Если значение равно 0, подключение к сокету будет выполняться без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию формат — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичные блоки fileb:// всегда будет обрабатываться как двоичные данные и использовать содержимое файла напрямую независимо от cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить пагинатор cli для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, у вас должен быть установлен и настроен AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила кавычек, характерные для Unix-подобных систем. Эти примеры необходимо адаптировать к правилам кавычек вашей терминальной среды. См. использование кавычек со строками в Руководстве пользователя AWS CLI.

Для ожидания готовности подсети

Следующий wait subnet-available пример приостанавливает и возобновляет выполнение только после подтверждения готовности указанной подсети. Он не генерирует вывод.

aws ec2 wait subnet-available \
    --subnet-ids subnet-1234567890abcdef0

Вывод

Нет