describe-instance-status

Описание

Описывает состояние указанных экземпляров или всех ваших экземпляров. По умолчанию описываются только запущенные экземпляры, если вы не укажете явно, что нужно вернуть состояние всех экземпляров.

Состояние экземпляра включает следующие компоненты:

• Проверки состояния - Amazon EC2 выполняет проверки состояния запущенных экземпляров EC2 для выявления проблем с аппаратным и программным обеспечением. Дополнительную информацию см. в разделах «Проверки состояния ваших экземпляров» и «Устранение неполадок экземпляров с не пройденными проверками состояния» в руководстве пользователя Amazon EC2.
• Запланированные события - Amazon EC2 может планировать события (такие как перезагрузка, остановка или завершение работы) для ваших экземпляров, связанных с проблемами аппаратного обеспечения, обновлениями программного обеспечения или техническим обслуживанием системы. Дополнительную информацию см. в разделе «Запланированные события для ваших экземпляров» в руководстве пользователя Amazon EC2.
• Состояние экземпляра - Вы можете управлять своими экземплярами с момента запуска до завершения их работы. Дополнительную информацию см. в разделе «Жизненный цикл экземпляра» в руководстве пользователя Amazon EC2.

Amazon EC2 API использует модель конечной согласованности. Это означает, что результат API-команды, которую вы выполняете для создания или изменения ресурсов, может не быть сразу доступен для всех последующих команд, которые вы выполняете. Инструкции по управлению конечной согласованностью см. в разделе «Конечная согласованность в API Amazon EC2» в руководстве разработчика Amazon EC2.

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

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

Синтаксис

  describe-instance-status
[--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 (список)

Синтаксис:

"string" "string" ...

--dry-run | --no-dry-run (логическое значение)

--filters (список)

Сокращённый синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--include-all-instances | --no-include-all-instances (логическое значение)

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставляемому --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределяют значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.

--starting-token (строка)

--page-size (целое число)

--max-items (целое число)

--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.

Примеры

Для описания состояния экземпляра

Следующий describe-instance-status пример описывает текущее состояние указанного экземпляра.

aws ec2 describe-instance-status \
    --instance-ids i-1234567890abcdef0

Вывод:

{
    "InstanceStatuses": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "InstanceState": {
                "Code": 16,
                "Name": "running"
            },
            "AvailabilityZone": "us-east-1d",
            "SystemStatus": {
                "Status": "ok",
                "Details": [
                    {
                        "Status": "passed",
                        "Name": "reachability"
                    }
                ]
            },
            "InstanceStatus": {
                "Status": "ok",
                "Details": [
                    {
                        "Status": "passed",
                        "Name": "reachability"
                    }
                ]
            }
        }
    ]
}

Дополнительную информацию см. в разделе Отслеживание состояния ваших экземпляров в Руководстве пользователя Amazon EC2.

Вывод

InstanceStatuses -> (список)