system-status-ok
Описание
Ожидает, пока JMESPath-запрос InstanceStatuses[].SystemStatus.Status вернёт значение ok для всех элементов при опросе с помощью describe-instance-status. Будет выполняться опрос каждые 15 секунд до достижения успешного состояния. Код возврата 255 будет выдан после 40 неудачных проверок.
См. также: Документацию API AWS
system-status-ok — это операция с постраничной обработкой. Для получения всего набора результатов могут быть вызваны несколько API-запросов. Вы можете отключить постраничную обработку, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query для ответа с постраничной обработкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: InstanceStatuses
Синтаксис
system-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).
(структура)
Пара имя-значение фильтра, используемая для получения более конкретного списка результатов из операции описания. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как теги, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, они объединяются с помощью 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 (логическое значение)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство «Начало работы» в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры потребуется адаптировать к правилам цитирования вашей оболочки. См. использование кавычек с строками в руководстве пользователя AWS CLI.
Для ожидания, пока статус системы не станет OK
Следующая wait system-status-ok команда примера приостанавливает и возобновляет выполнение только после подтверждения, что статус системы указанного экземпляра — OK. Вывода нет.
aws ec2 wait system-status-ok \
--instance-ids i-1234567890abcdef0
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.