Spec-Zone.ru › AWS CLI v2

[ aws . ec2 . wait ]

security-group-exists

Описание

Ожидайте, пока длина запроса JMESPath (SecurityGroups[].GroupId) > 0 вернёт True при опросе с помощью describe-security-groups. Будет происходить опрос каждые 5 секунд до достижения успешного состояния. Команда завершится с кодом возврата 255 после 6 неудачных проверок.

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

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

Синтаксис

  security-group-exists
[--group-ids <value>]
[--group-names <value>]
[--dry-run | --no-dry-run]
[--filters <value>]
[--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]

Параметры

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

Идентификаторы групп безопасности. Требуется для групп безопасности в VPC по умолчанию.

По умолчанию: описывает все ваши группы безопасности.

(строка)

Синтаксис:

"string" "string" ...

--group-names (список)

[ВPC по умолчанию] Имена групп безопасности. Вы можете указать либо имя группы безопасности, либо идентификатор группы безопасности.

По умолчанию: описывает все ваши группы безопасности.

(строка)

Синтаксис:

"string" "string" ...

--dry-run | --no-dry-run (булево)

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

--filters (список)

Фильтры. Если используется несколько фильтров для правил, результаты включают группы безопасности, для которых любая комбинация правил — а не обязательно одно правило — соответствует всем фильтрам.

  • description — описание группы безопасности.
  • egress.ip-permission.cidr — IPv4 блок CIDR для правила группы безопасности исходящего трафика.
  • egress.ip-permission.from-port — для правила исходящего трафика, начало диапазона портов для протоколов TCP и UDP или номер типа ICMP.
  • egress.ip-permission.group-id — ID группы безопасности, на которую ссылается правило группы безопасности исходящего трафика.
  • egress.ip-permission.group-name — имя группы безопасности, на которую ссылается правило группы безопасности исходящего трафика.
  • egress.ip-permission.ipv6-cidr — IPv6 блок CIDR для правила группы безопасности исходящего трафика.
  • egress.ip-permission.prefix-list-id — ID списка префиксов, которому правило группы безопасности позволяет исходящий доступ.
  • egress.ip-permission.protocol — протокол IP для правила группы безопасности исходящего трафика (tcp | udp | icmp, номер протокола или -1 для всех протоколов).
  • egress.ip-permission.to-port — для правила исходящего трафика, конец диапазона портов для протоколов TCP и UDP или код ICMP.
  • egress.ip-permission.user-id — ID учетной записи Amazon Web Services, на которую ссылается правило группы безопасности исходящего трафика.
  • group-id — ID группы безопасности.
  • group-name — имя группы безопасности.
  • ip-permission.cidr — IPv4 блок CIDR для правила группы безопасности входящего трафика.
  • ip-permission.from-port — для правила входящего трафика, начало диапазона портов для протоколов TCP и UDP или номер типа ICMP.
  • ip-permission.group-id — ID группы безопасности, на которую ссылается правило группы безопасности входящего трафика.
  • ip-permission.group-name — имя группы безопасности, на которую ссылается правило группы безопасности входящего трафика.
  • ip-permission.ipv6-cidr — IPv6 блок CIDR для правила группы безопасности входящего трафика.
  • ip-permission.prefix-list-id — ID списка префиксов, из которого правило группы безопасности разрешает входящий доступ.
  • ip-permission.protocol — протокол IP для правила группы безопасности входящего трафика (tcp | udp | icmp, номер протокола или -1 для всех протоколов).
  • ip-permission.to-port — для правила входящего трафика, конец диапазона портов для протоколов TCP и UDP или код ICMP.
  • ip-permission.user-id — ID учетной записи Amazon Web Services, на которую ссылается правило группы безопасности входящего трафика.
  • owner-id — ID учетной записи Amazon Web Services владельца группы безопасности.
  • tag :<key> — пара ключ/значение тега, назначенного ресурсу. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, у которых есть тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
  • tag-key — ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которым назначен тег с определённым ключом, независимо от значения тега.
  • vpc-id — ID VPC, указанный при создании группы безопасности.

(структура)

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

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

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

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

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

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

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

(строка)

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

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

Синтаксис JSON:

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

--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)

Файл с корневым сертификатом для проверки 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-auto-prompt (boolean)

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

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

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

Примеры

Примечание

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

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

Для приостановки выполнения, пока не будет создан сетевой интерфейс безопасности

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

aws ec2 wait security-group-exists \
    --group-ids sg-07e789d0fb10492ee

Эта команда не выводит никакой информации.

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API