instance-status-ok
Описание
Ожидайте, пока JMESPath запрос InstanceStatuses[].InstanceStatus.Status вернёт значение ok для всех элементов при опросе с помощью describe-instance-status. Будет происходить опрос каждые 15 секунд, пока не будет достигнуто успешное состояние. Команда завершится с кодом возврата 255 после 40 неудачных проверок.
См. также: Документацию API AWS
instance-status-ok является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query для постраничного ответа, аргумент --query должен извлекать данные из результатов следующих выражений запросов: InstanceStatuses
Синтаксис
instance-status-ok
[--instance-ids <value>]
[--dry-run | --no-dry-run]
[--filters <value>]
[--include-all-instances | --no-include-all-instances]
[--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 (список)
Идентификаторы экземпляров.
По умолчанию: описывает все ваши экземпляры.
Ограничения: Максимальное количество явно указанных идентификаторов экземпляров — 100.
(строка)
Синтаксис:
"string" "string" ...
--dry-run | --no-dry-run (логическое значение)
DryRunOperation. В противном случае — UnauthorizedOperation.--filters (список)
Фильтры.
-
availability-zone- Доступная зона экземпляра. -
event.code- Код запланированного события (instance-reboot|system-reboot|system-maintenance|instance-retirement|instance-stop). -
event.description- Описание события. -
event.instance-event-id- Идентификатор события, дату и время которого вы изменяете. -
event.not-after- Самое позднее время завершения запланированного события (например,2014-09-15T17:15:20.000Z). -
event.not-before- Самое раннее время начала запланированного события (например,2014-09-15T17:15:20.000Z). -
event.not-before-deadline- Срок для начала события (например,2014-09-15T17:15:20.000Z). -
instance-state-code- Код состояния экземпляра в виде 16-битного беззнакового целого числа. Старший байт используется для внутренних целей и должен быть проигнорирован. Младший байт устанавливается на основе представленного состояния. Допустимые значения: 0 (ожидание), 16 (работает), 32 (выключается), 48 (завершён), 64 (останавливается) и 80 (остановлен). -
instance-state-name- Состояние экземпляра (pending|running|shutting-down|terminated|stopping|stopped). -
instance-status.reachability- Фильтры состояния экземпляра, где имя равноreachability(passed|failed|initializing|insufficient-data). -
instance-status.status- Состояние экземпляра (ok|impaired|initializing|insufficient-data|not-applicable). -
operator.managed- Логическое значение, указывающее, является ли это управляемым экземпляром. -
operator.principal- Принципал, управляющий экземпляром. Действителен только для управляемых экземпляров, гдеmanagedравенtrue. -
system-status.reachability- Фильтры состояния системы, где имя равноreachability(passed|failed|initializing|insufficient-data). -
system-status.status- Состояние системы экземпляра (ok|impaired|initializing|insufficient-data|not-applicable). -
attached-ebs-status.status- Состояние подключённого тома EBS для экземпляра (ok|impaired|initializing|insufficient-data|not-applicable).
(структура)
Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как метки, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, фильтры объединяются с помощью AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.
Дополнительную информацию см. в разделе Списки и фильтрация с помощью командной строки и API в Руководстве пользователя Amazon EC2.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью OR, и запрос возвращает все результаты, соответствующие любому из указанных значений.
(строка)
Сокращённый синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--include-all-instances | --no-include-all-instances (логическое значение)
При true, включает состояние здоровья всех экземпляров. При false, включает состояние здоровья только работающих экземпляров.
По умолчанию: false
--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 (логическое значение)
Включить отладку ведения журнала.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команд.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
JMESPath запрос для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включение/отключение цветного вывода.
- включено
- выключено
- автоматически
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию — 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 (логическое значение)
Отключить паджер командной строки для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры командной строки.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запрошение параметров командной строки.
Примеры
Примечание
Чтобы использовать следующие примеры, у вас должен быть установлен и настроен AWS CLI. Дополнительную информацию см. в руководстве «Начало работы» в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования, подобные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. раздел «Использование кавычек со строками» в Руководстве пользователя AWS CLI.
Чтобы дождаться, пока статус экземпляра станет OK
Следующий wait instance-status-ok пример приостанавливает и возобновляет выполнение только после подтверждения, что статус указанного экземпляра OK. Вывода не генерируется.
aws ec2 wait instance-status-ok \
--instance-ids i-1234567890abcdef0
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.