Spec-Zone.ru › AWS CLI v2

[ aws . ec2 . wait ]

instance-stopped

Описание

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

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

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

Синтаксис

  instance-stopped
[--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 - Профиль экземпляра, связанный с экземпляром. Указан как идентификатор.
  • 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) шлюза.
  • 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-read-timeout (int)

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

--cli-connect-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 для вывода.

--cli-auto-prompt (boolean)

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

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

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

Примеры

Примечание

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

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

Ожидание остановки экземпляра

Следующий wait instance-stopped пример приостанавливает и возобновляет выполнение только после подтверждения, что указанный экземпляр остановлен. Вывод отсутствует.

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

Вывод

Нет

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

Spec-Zone.ru

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