Spec-Zone.ru › AWS CLI v2

[ aws . ec2 . wait ]

instance-running

Описание

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

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

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

Синтаксис

  instance-running
[--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 - Логическое значение, указывающее, включены ли 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, запланированным экземпляром или блоком емкости (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 филиала.
  • 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 означает, что проверка отключена. Для того, чтобы экземпляр выполнял трансляцию сетевых адресов (NAT) в вашей VPC, значение должно быть false.
  • 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 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-running пример приостанавливается и возобновляется только после подтверждения запуска указанного экземпляра. Он не генерирует вывод.

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

Вывод

Нет

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

Spec-Zone.ru

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