Spec-Zone.ru › AWS CLI v2

[ aws . ec2 . wait ]

instance-terminated

Описание

Ожидание, пока запрос JMESPath Reservations[].Instances[].State.Name вернет terminated для всех элементов при опросе с describe-instances. Он будет опрашивать каждые 15 секунд, пока не будет достигнут успешный статус. При 40 неудачных проверках, вызов завершится с кодом возврата 255.

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

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

Синтаксис

  instance-terminated
[--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, в которую был запущен экземпляр.
  • capacity-reservation-specification.capacity-reservation-preference - Предпочтение экземпляра по резервированию ресурсов Capacity (open | none ).
  • capacity-reservation-specification.capacity-reservation-target.capacity-reservation-id - Идентификатор целевой резервированной группы Capacity.
  • capacity-reservation-specification.capacity-reservation-target.capacity-reservation-resource-group-arn - ARN целевой группы резервирования Capacity.
  • client-token - Маркер идемпотентности, который вы предоставили при запуске экземпляра.
  • current-instance-boot-mode - Режим загрузки, используемый для запуска или запуска экземпляра (legacy-bios | uefi ).
  • dns-name - Публичное DNS-имя экземпляра.
  • ebs-optimized - Логическое значение, указывающее, оптимизирован ли экземпляр для ввода/вывода Amazon EBS.
  • ena-support - Логическое значение, указывающее, включена ли усовершенствованная сеть с ENA для экземпляра.
  • enclave-options.enabled - Логическое значение, указывающее, включены ли Nitro Enclaves Amazon Web Services для экземпляра.
  • hibernation-options.configured - Логическое значение, указывающее, включена ли функция приостановки для экземпляра. Значение true означает, что функция приостановки включена.
  • host-id - Идентификатор выделенного хоста, на котором работает экземпляр, применимо.
  • hypervisor - Тип гипервизора экземпляра (ovm | xen ). Значение xen используется для гипервизоров Xen и Nitro.
  • iam-instance-profile.arn - Профиль экземпляра, связанный с экземпляром. Указан как ARN.
  • iam-instance-profile.id - Профиль экземпляра, связанный с экземпляром. Указан как идентификатор.
  • image-id - Идентификатор образа, используемого для запуска экземпляра.
  • instance-id - Идентификатор экземпляра.
  • instance-lifecycle - Указывает, является ли это экземпляром Spot, запланированным экземпляром или блоком Capacity (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 - Предел перепрыгивания ответа на запрос 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) экзопоста.
  • 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, 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 , и запрос возвращает только результаты, которые соответствуют всем указанным фильтрам.

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

Name -> (строка)

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

Values -> (список)

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью 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 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 instance-terminated пример приостанавливается и возобновляется только после подтверждения завершения работы указанного экземпляра. Он не генерирует никакого вывода.

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

Вывод

Нет

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

Spec-Zone.ru

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