интерфейс-сети-доступен

Описание

Ожидание, пока JMESPath запрос NetworkInterfaces[].Status вернёт значение available для всех элементов при опросе с помощью describe-network-interfaces. Он будет опрашивать каждые 20 секунд, пока не будет достигнуто успешное состояние. Код возврата 255 будет выдан после 10 неудачных проверок.

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

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

Синтаксис

  network-interface-available
[--dry-run | --no-dry-run]
[--network-interface-ids <value>]
[--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]

Параметры

--dry-run | --no-dry-run (boolean)

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

--network-interface-ids (список)

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

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

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Один или несколько фильтров.

association.allocation-id - Идентификатор выделения, возвращённый при выделении Elastic IP-адреса (IPv4) для вашего интерфейса сети.
association.association-id - Идентификатор ассоциации, возвращённый при ассоциации интерфейса сети с IPv4-адресом.
addresses.association.owner-id - Идентификатор владельца адресов, связанных с интерфейсом сети.
addresses.association.public-ip - Идентификатор ассоциации, возвращённый при ассоциации интерфейса сети с Elastic IP-адресом (IPv4).
addresses.primary - Является ли частный IPv4-адрес основным IP-адресом, связанным с интерфейсом сети.
addresses.private-ip-address - Частные IPv4-адреса, связанные с интерфейсом сети.
association.ip-owner-id - Владелец Elastic IP-адреса (IPv4), связанного с интерфейсом сети.
association.public-ip - Адрес Elastic IP-адреса (IPv4), привязанного к интерфейсу сети.
association.public-dns-name - Публичное DNS-имя интерфейса сети (IPv4).
attachment.attach-time - Время присоединения интерфейса сети к экземпляру.
attachment.attachment-id - Идентификатор присоединения интерфейса.
attachment.delete-on-termination - Указывается ли, что присоединение удаляется при завершении работы экземпляра.
attachment.device-index - Индекс устройства, к которому подключен интерфейс сети.
attachment.instance-id - Идентификатор экземпляра, к которому подключен интерфейс сети.
attachment.instance-owner-id - Идентификатор владельца экземпляра, к которому подключен интерфейс сети.
attachment.status - Состояние присоединения (attaching | attached | detaching | detached).
availability-zone - Доступная зона интерфейса сети.
description - Описание интерфейса сети.
group-id - Идентификатор группы безопасности, связанной с интерфейсом сети.
ipv6-addresses.ipv6-address - IPv6-адрес, связанный с интерфейсом сети.
interface-type - Тип интерфейса сети (api_gateway_managed | aws_codestar_connections_managed | branch | ec2_instance_connect_endpoint | efa | efa-only | efs | gateway_load_balancer | gateway_load_balancer_endpoint | global_accelerator_managed | interface | iot_rules_managed | lambda | load_balancer | nat_gateway | network_load_balancer | quicksight | transit_gateway | trunk | vpc_endpoint).
mac-address - MAC-адрес интерфейса сети.
network-interface-id - Идентификатор интерфейса сети.
operator.managed - Булево значение, указывающее, является ли это управляемым интерфейсом сети.
operator.principal - Сущность, управляющая интерфейсом сети. Действительно только для управляемых интерфейсов сети, где managed равно true.
owner-id - Идентификатор учётной записи Amazon Web Services владельца интерфейса сети.
private-dns-name - Частное DNS-имя интерфейса сети (IPv4).
private-ip-address - Частные IPv4-адрес или адреса интерфейса сети.
requester-id - Псевдоним или идентификатор учётной записи Amazon Web Services сущности или службы, создавшей интерфейс сети.
requester-managed - Указывает, управляется ли интерфейс сети службой Amazon Web Services (например, Amazon Web Services Management Console, Auto Scaling и т.д.).
source-dest-check - Указывает, выполняет ли интерфейс сети проверку источника/назначения. Значение true означает, что проверка включена, а false означает, что проверка отключена. Значение должно быть false для того, чтобы интерфейс сети выполнял трансляцию сетевых адресов (NAT) в вашей VPC.
status - Состояние интерфейса сети. Если интерфейс сети не подключён к экземпляру, состояние равно available; если интерфейс сети подключён к экземпляру, состояние равно in-use.
subnet-id - Идентификатор подсети для интерфейса сети.
tag :<key> - Пара ключевое слово/значение тега, назначенного ресурсу. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key - Ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которым назначен тег с определённым ключом, независимо от значения тега.
vpc-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)

Пакет сертификатов 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 network-interface-available пример приостанавливает и возобновляет выполнение только после подтверждения доступности указанного сетевого интерфейса. Он не генерирует вывод.

aws ec2 wait network-interface-available \
    --network-interface-ids eni-1234567890abcdef0

Вывод

Нет