Spec-Zone.ru › AWS CLI v2

[ aws . ec2 . wait ]

instance-exists

Описание

Ожидание, пока длина запроса JMESPath (Reservations[]) > 0 возвращает True при опросе с помощью describe-instances. Будет происходить опрос каждые 5 секунд до достижения успешного состояния. Выход с кодом возврата 255 после 40 неудачных проверок.

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

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

Синтаксис

  instance-exists
[--instance-ids <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]

Параметры

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

Идентификаторы экземпляров.

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

(строка)

Синтаксис:

"string" "string" ...

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

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

--filters (список)

Фильтры.

  • affinity - Настройка сродства для экземпляра, работающего на выделенном хосте (default | host ).
  • architecture - Архитектура экземпляра (i386 | x86_64 | arm64 ).
  • availability-zone - Доступная зона экземпляра.
  • block-device-mapping.attach-time - Время подключения тома EBS, подключенного к экземпляру, например, 2022-09-15T17:15:20.000Z .
  • block-device-mapping.delete-on-termination - Логическое значение, указывающее, будет ли том EBS удалён при завершении работы экземпляра.
  • block-device-mapping.device-name - Имя устройства, указанное в отображении блочных устройств (например, /dev/sdh или xvdh ).
  • block-device-mapping.status - Состояние тома EBS (attaching | attached | detaching | detached ).
  • block-device-mapping.volume-id - Идентификатор тома EBS.
  • boot-mode - Режим загрузки, указанный AMI (legacy-bios | uefi | uefi-preferred ).
  • capacity-reservation-id - Идентификатор резервирования емкости, в который был запущен экземпляр.
  • capacity-reservation-specification.capacity-reservation-preference - Предпочтение экземпляра резервирования емкости (open | none ).
  • capacity-reservation-specification.capacity-reservation-target.capacity-reservation-id - Идентификатор целевого резервирования емкости.
  • capacity-reservation-specification.capacity-reservation-target.capacity-reservation-resource-group-arn - ARN целевой группы резервирования емкости.
  • client-token - Маркер идемпотентности, предоставленный вами при запуске экземпляра.
  • current-instance-boot-mode - Режим загрузки, используемый для запуска или запуска экземпляра (legacy-bios | uefi ).
  • dns-name - Публичное DNS-имя экземпляра.
  • ebs-optimized - Логическое значение, указывающее, оптимизирован ли экземпляр для ввода/вывода Amazon EBS.
  • ena-support - Логическое значение, указывающее, включено ли для экземпляра расширенное сетевое взаимодействие с ENA.
  • enclave-options.enabled - Логическое значение, указывающее, включены ли для экземпляра службы Amazon Web Services Nitro Enclaves.
  • hibernation-options.configured - Логическое значение, указывающее, включено ли для экземпляра приостановление. Значение true означает, что приостановление для экземпляра включено.
  • host-id - Идентификатор выделенного хоста, на котором работает экземпляр, если применимо.
  • hypervisor - Тип гипервизора экземпляра (ovm | xen ). Значение xen используется для гипервизоров Xen и Nitro.
  • iam-instance-profile.arn - Профиль экземпляра, связанный с экземпляром. Указан как ARN.
  • iam-instance-profile.id - Профиль экземпляра, связанный с экземпляром. Указан как ID.
  • image-id - Идентификатор образа, используемого для запуска экземпляра.
  • instance-id - Идентификатор экземпляра.
  • instance-lifecycle - Указывает, является ли это экземпляром Spot, запланированным экземпляром или блоком емкости (spot | scheduled | capacity-block ).
  • instance-state-code - Состояние экземпляра в виде 16-битного беззнакового целого числа. Старший байт используется для внутренних целей и должен быть проигнорирован. Младший байт устанавливается в зависимости от представленного состояния. Допустимые значения: 0 (ожидание), 16 (работает), 32 (выключается), 48 (завершён), 64 (останавливается) и 80 (остановлен).
  • instance-state-name - Состояние экземпляра (pending | running | shutting-down | terminated | stopping | stopped ).
  • instance-type - Тип экземпляра (например, t2.micro ).
  • instance.group-id - Идентификатор группы безопасности для экземпляра.
  • instance.group-name - Название группы безопасности для экземпляра.
  • ip-address - Публичный IPv4-адрес экземпляра.
  • ipv6-address - IPv6-адрес экземпляра.
  • kernel-id - Идентификатор ядра.
  • key-name - Имя пары ключей, используемой при запуске экземпляра.
  • launch-index - При запуске нескольких экземпляров это индекс экземпляра в группе запуска (например, 0, 1, 2 и т. д.).
  • launch-time - Время запуска экземпляра в формате ISO 8601 в часовом поясе UTC (ГГГГ-ММ-ДДТчч:мм:сс.мсZ), например, 2021-09-29T11:04:43.305Z . Можно использовать подстановочный знак (* ), например, 2021-09-29T* , который соответствует всему дню.
  • maintenance-options.auto-recovery - Текущее поведение автоматического восстановления экземпляра (disabled | default ).
  • metadata-options.http-endpoint - Состояние доступа к конечной точке HTTP метаданных на вашем экземпляре (enabled | disabled )
  • metadata-options.http-protocol-ipv4 - Указание, включена ли конечная точка IPv4 (disabled | enabled ).
  • metadata-options.http-protocol-ipv6 - Указание, включена ли конечная точка IPv6 (disabled | enabled ).
  • metadata-options.http-put-response-hop-limit - Предел прыжков ответа put ответа запроса HTTP метаданных (целое число, возможные значения 1 до 64 )
  • metadata-options.http-tokens - Состояние авторизации запроса метаданных (optional | required )
  • metadata-options.instance-metadata-tags - Состояние доступа к меткам экземпляра из метаданных экземпляра (enabled | disabled )
  • metadata-options.state - Состояние изменений параметра метаданных (pending | applied ).
  • monitoring-state - Указание, включено ли подробное мониторинг (disabled | enabled ).
  • network-interface.addresses.association.allocation-id - Идентификатор выделения.
  • network-interface.addresses.association.association-id - Идентификатор ассоциации.
  • network-interface.addresses.association.carrier-ip - Адрес оператора IP.
  • network-interface.addresses.association.customer-owned-ip - Адрес IP, принадлежащий клиенту.
  • network-interface.addresses.association.ip-owner-id - Идентификатор владельца частного IPv4-адреса, связанного с сетевым интерфейсом.
  • network-interface.addresses.association.public-dns-name - Публичное DNS-имя.
  • network-interface.addresses.association.public-ip - Идентификатор ассоциации Elastic IP-адреса (IPv4) с сетевым интерфейсом.
  • network-interface.addresses.primary - Указывает, является ли IPv4-адрес сетевого интерфейса основным частным IPv4-адресом.
  • network-interface.addresses.private-dns-name - Частное DNS-имя.
  • network-interface.addresses.private-ip-address - Частный IPv4-адрес, связанный с сетевым интерфейсом.
  • network-interface.association.allocation-id - Идентификатор выделения, возвращённый при выделении Elastic IP-адреса (IPv4) для вашего сетевого интерфейса.
  • network-interface.association.association-id - Идентификатор ассоциации, возвращённый при ассоциации сетевого интерфейса с IPv4-адресом.
  • network-interface.association.carrier-ip - Адрес IP, принадлежащий клиенту.
  • network-interface.association.customer-owned-ip - Адрес IP, принадлежащий клиенту.
  • network-interface.association.ip-owner-id - Владелец Elastic IP-адреса (IPv4), связанного с сетевым интерфейсом.
  • network-interface.association.public-dns-name - Публичное DNS-имя.
  • network-interface.association.public-ip - Адрес Elastic IP-адреса (IPv4), привязанного к сетевому интерфейсу.
  • network-interface.attachment.attach-time - Время подключения сетевого интерфейса к экземпляру.
  • network-interface.attachment.attachment-id - Идентификатор подключения интерфейса.
  • network-interface.attachment.delete-on-termination - Указывает, удаляется ли подключение при завершении работы экземпляра.
  • network-interface.attachment.device-index - Индекс устройства, к которому подключен сетевой интерфейс.
  • network-interface.attachment.instance-id - Идентификатор экземпляра, к которому подключен сетевой интерфейс.
  • network-interface.attachment.instance-owner-id - Идентификатор владельца экземпляра, к которому подключен сетевой интерфейс.
  • network-interface.attachment.network-card-index - Индекс сетевой карты.
  • network-interface.attachment.status - Состояние подключения (attaching | attached | detaching | detached ).
  • network-interface.availability-zone - Доступная зона для сетевого интерфейса.
  • network-interface.deny-all-igw-traffic - Логическое значение, указывающее, недоступен ли сетевой интерфейс с IPv6-адресом из общедоступного интернета.
  • network-interface.description - Описание сетевого интерфейса.
  • network-interface.group-id - Идентификатор группы безопасности, связанной с сетевым интерфейсом.
  • network-interface.group-name - Название группы безопасности, связанной с сетевым интерфейсом.
  • network-interface.ipv4-prefixes.ipv4-prefix - IPv4-префиксы, назначенные сетевому интерфейсу.
  • network-interface.ipv6-address - IPv6-адрес, связанный с сетевым интерфейсом.
  • network-interface.ipv6-addresses.ipv6-address - IPv6-адрес, связанный с сетевым интерфейсом.
  • network-interface.ipv6-addresses.is-primary-ipv6 - Логическое значение, указывающее, является ли это основным IPv6-адресом.
  • network-interface.ipv6-native - Логическое значение, указывающее, является ли это сетевым интерфейсом только с IPv6.
  • network-interface.ipv6-prefixes.ipv6-prefix - IPv6-префикс, назначенный сетевому интерфейсу.
  • network-interface.mac-address - MAC-адрес сетевого интерфейса.
  • network-interface.network-interface-id - Идентификатор сетевого интерфейса.
  • network-interface.operator.managed - Логическое значение, указывающее, имеет ли экземпляр управляемый сетевой интерфейс.
  • network-interface.operator.principal - Сущность, управляющая сетевым интерфейсом. Действительно только для экземпляров с управляемыми сетевыми интерфейсами, где managed является true .
  • network-interface.outpost-arn - ARN Outpost.
  • network-interface.owner-id - Идентификатор владельца сетевого интерфейса.
  • network-interface.private-dns-name - Частное DNS-имя сетевого интерфейса.
  • network-interface.private-ip-address - Частный IPv4-адрес.
  • network-interface.public-dns-name - Публичное DNS-имя.
  • network-interface.requester-id - Идентификатор запросчика для сетевого интерфейса.
  • network-interface.requester-managed - Указывает, управляет ли Amazon Web Services сетевым интерфейсом.
  • network-interface.status - Состояние сетевого интерфейса (available ) | in-use ).
  • network-interface.source-dest-check - Выполняет ли сетевой интерфейс проверку источника/назначения. Значение true означает, что проверка включена, а false означает, что проверка отключена. Значение должно быть false, чтобы сетевой интерфейс выполнял трансляцию сетевых адресов (NAT) в вашей VPC.
  • network-interface.subnet-id - Идентификатор подсети для сетевого интерфейса.
  • network-interface.tag-key - Ключ метки, назначенной сетевому интерфейсу.
  • network-interface.tag-value - Значение метки, назначенной сетевому интерфейсу.
  • network-interface.vpc-id — Идентификатор VPC для сетевого интерфейса.
  • network-performance-options.bandwidth-weighting — Место, где применяется повышение производительности (если применимо). Допустимые значения: default , vpc-1 , ebs-1 .
  • operator.managed — Логическое значение, указывающее, является ли это управляемым экземпляром.
  • operator.principal — Субъект, управляющий экземпляром. Действительно только для управляемых экземпляров, где managed равно true .
  • outpost-arn — Amazon Resource Name (ARN) Outpost.
  • owner-id — Идентификатор учетной записи Amazon Web Services владельца экземпляра.
  • placement-group-name — Название группы размещения для экземпляра.
  • placement-partition-number — Раздел, в котором расположен экземпляр.
  • platform — Платформа. Чтобы отобразить только экземпляры Windows, используйте windows .
  • platform-details — Платформа (Linux/UNIX | Red Hat BYOL Linux | Red Hat Enterprise Linux | Red Hat Enterprise Linux with HA | Red Hat Enterprise Linux with SQL Server Standard and HA | Red Hat Enterprise Linux with SQL Server Enterprise and HA | Red Hat Enterprise Linux with SQL Server Standard | Red Hat Enterprise Linux with SQL Server Web | Red Hat Enterprise Linux with SQL Server Enterprise | SQL Server Enterprise | SQL Server Standard | SQL Server Web | SUSE Linux | Ubuntu Pro | Windows | Windows BYOL | Windows with SQL Server Enterprise | Windows with SQL Server Standard | Windows with SQL Server Web ).
  • private-dns-name — Частное имя DNS IPv4 экземпляра.
  • private-dns-name-options.enable-resource-name-dns-a-record — Логическое значение, указывающее, нужно ли отвечать на запросы DNS для имен хостов экземпляра с помощью записей DNS A.
  • private-dns-name-options.enable-resource-name-dns-aaaa-record — Логическое значение, указывающее, нужно ли отвечать на запросы DNS для имен хостов экземпляра с помощью записей DNS AAAA.
  • private-dns-name-options.hostname-type — Тип имени хоста (ip-name | resource-name ).
  • private-ip-address — Частный IPv4-адрес экземпляра. Его можно использовать только для фильтрации по первичному IP-адресу сетевого интерфейса, подключенного к экземпляру. Для фильтрации по дополнительным IP-адресам, назначенным сетевому интерфейсу, используйте фильтр network-interface.addresses.private-ip-address .
  • product-code — Код продукта, связанный с AMI, используемой для запуска экземпляра.
  • product-code.type — Тип кода продукта (devpay | marketplace ).
  • ramdisk-id — Идентификатор RAM-диска.
  • reason — Причина текущего состояния экземпляра (например, показывает «Инициализировано пользователем [дата]», когда вы останавливаете или завершаете экземпляр). Аналогично фильтру state-reason-code.
  • requester-id — Идентификатор сущности, которая запустила экземпляр от вашего имени (например, Amazon Web Services Management Console, Auto Scaling и т. д.).
  • reservation-id — Идентификатор резервации экземпляра. Идентификатор резервации создается всякий раз, когда вы запускаете экземпляр. Идентификатор резервации имеет однозначное соответствие с запросом на запуск экземпляра, но может быть связан с более чем одним экземпляром, если вы запускаете несколько экземпляров с помощью одного запроса на запуск. Например, если вы запускаете один экземпляр, вы получаете один идентификатор резервации. Если вы запускаете десять экземпляров с помощью одного запроса на запуск, вы также получаете один идентификатор резервации.
  • root-device-name — Имя устройства тома корневого устройства (например, /dev/sda1 ).
  • root-device-type — Тип тома корневого устройства (ebs | instance-store ).
  • source-dest-check — Указывает, выполняет ли экземпляр проверку источника/назначения. Значение true означает, что проверка включена, а false означает, что проверка отключена. Значение должно быть false для выполнения экземпляром трансляции сетевых адресов (NAT) в вашей VPC.
  • spot-instance-request-id — Идентификатор запроса Spot Instance.
  • state-reason-code — Код причины изменения состояния.
  • state-reason-message — Сообщение, описывающее изменение состояния.
  • subnet-id — Идентификатор подсети для экземпляра.
  • tag:<key> — Комбинация ключ/значение тега, назначенного ресурсу. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, которые имеют тег с ключом Owner и значением TeamA , укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
  • tag-key — Ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которые имеют тег с определенным ключом, независимо от значения тега.
  • tenancy — Аренда экземпляра (dedicated | default | host ).
  • tpm-support — Указывает, настроен ли экземпляр для поддержки NitroTPM (v2.0 ).
  • usage-operation — Значение операции использования для экземпляра (RunInstances | RunInstances:00g0 | RunInstances:0010 | RunInstances:1010 | RunInstances:1014 | RunInstances:1110 | RunInstances:0014 | RunInstances:0210 | RunInstances:0110 | RunInstances:0100 | RunInstances:0004 | RunInstances:0200 | RunInstances:000g | RunInstances:0g00 | RunInstances:0002 | RunInstances:0800 | RunInstances:0102 | RunInstances:0006 | RunInstances:0202 ).
  • usage-operation-update-time — Время последнего обновления операции использования, например, 2022-09-15T17:15:20.000Z .
  • virtualization-type — Тип виртуализации экземпляра (paravirtual | hvm ).
  • vpc-id — Идентификатор VPC, в котором работает экземпляр.

(структура)

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

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

Дополнительную информацию см. в разделе Список и фильтрация с помощью командной строки и 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-connect-timeout (int)

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

--cli-read-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого файла, отображающего двоичный блок, 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 instance-exists пример приостанавливается и возобновляется только после подтверждения существования указанного экземпляра. Он не производит вывод.

aws ec2 wait instance-exists \
  --instance-ids i-1234567890abcdef0

Вывод

Нет

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

Spec-Zone.ru

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