vpc-exists
Описание
Ожидание получения ответа 200 при опросе с помощью describe-vpcs. Будет происходить опрос каждые 1 секунду до достижения успешного состояния. Команда завершится с кодом возврата 255 после 5 неудачных проверок.
См. также: Документацию API AWS
vpc-exists — это операция с постраничной обработкой. Для получения всего набора результатов могут быть вызваны несколько API-запросов. Вы можете отключить постраничную обработку, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query с результатами постраничной обработки аргумент --query должен извлекать данные из результатов следующих выражений запроса: Vpcs
Синтаксис
vpc-exists
[--filters <value>]
[--vpc-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 (список)
Фильтры.
-
cidr- Основной IPv4 CIDR-блок VPC. Указанный CIDR-блок должен точно совпадать с CIDR-блоком VPC для получения информации о VPC. Должен содержать слеш, за которым следует одна или две цифры (например,/28). -
cidr-block-association.cidr-block- IPv4 CIDR-блок, связанный с VPC. -
cidr-block-association.association-id- Идентификатор ассоциации IPv4 CIDR-блока, связанного с VPC. -
cidr-block-association.state- Состояние IPv4 CIDR-блока, связанного с VPC. -
dhcp-options-id- Идентификатор набора DHCP-параметров. -
ipv6-cidr-block-association.ipv6-cidr-block- IPv6 CIDR-блок, связанный с VPC. -
ipv6-cidr-block-association.ipv6-pool- Идентификатор пула IPv6-адресов, из которого выделяется IPv6 CIDR-блок. -
ipv6-cidr-block-association.association-id- Идентификатор ассоциации IPv6 CIDR-блока, связанного с VPC. -
ipv6-cidr-block-association.state- Состояние IPv6 CIDR-блока, связанного с VPC. -
is-default- Указывает, является ли VPC стандартным VPC. -
owner-id- Идентификатор учетной записи Amazon Web Services, владеющей VPC. -
state- Состояние VPC (pending|available). -
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", ...]
}
...
]
--vpc-ids (список)
Идентификаторы VPC.
(строка)
Синтаксис:
"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 (булево)
Включение отладки.
--endpoint-url (строка)
Переопределяет URL по умолчанию команды заданным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (булево)
Отключение автоматической постраничной обработки. Если автоматическая постраничная обработка отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
JMESPath-запрос для фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включение/выключение цветного вывода.
- включено
- выключено
- автоматически
--no-sign-request (булево)
Отключение подписи запросов. Учетные данные не будут загружаться, если этот аргумент указан.
--ca-bundle (строка)
Файл с сертификатами CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию — 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 (булево)
Отключение пагинатора командной строки для вывода.
--cli-auto-prompt (булево)
Автоматическое запрос параметров командной строки.
--no-cli-auto-prompt (булево)
Отключение автоматического запроса параметров командной строки.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительная информация содержится в руководстве пользователя AWS CLI по началу работы.
Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Дополнительная информация содержится в руководстве пользователя AWS CLI по использованию кавычек со строками.
Для ожидания существования виртуальной частной сети (VPC)
Следующий wait vpc-exists пример команды приостанавливает и возобновляет выполнение только после подтверждения существования указанной VPC.
aws ec2 wait vpc-exists \
--vpc-ids vpc-1234567890abcdef0
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.