describe-instance-health
Описание
Описывает состояние указанных экземпляров по отношению к указанному балансировщику нагрузки. Если экземпляры не указаны, вызов описывает состояние всех экземпляров, которые в настоящее время зарегистрированы с балансировщиком нагрузки. Если экземпляры указаны, их состояние возвращается, даже если они больше не зарегистрированы с балансировщиком нагрузки. Состояние завершенных экземпляров не возвращается.
См. также: Документация API AWS
Синтаксис
describe-instance-health
--load-balancer-name <value>
[--instances <value>]
[--cli-input-json | --cli-input-yaml]
[--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]
Параметры
--load-balancer-name (строка)
--instances (список)
Идентификаторы экземпляров.
(структура)
Идентификатор экземпляра EC2.
InstanceId -> (строка)
Сокращенный синтаксис:
--instances InstanceId1 InstanceId2 InstanceId3
Синтаксис JSON:
[
{
"InstanceId": "string"
}
...
]
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, указанному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения перепишут значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного JSON-значения, так как строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.
--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.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. использование кавычек со строками в руководстве пользователя AWS CLI.
Для описания состояния экземпляров балансировщика нагрузки
Этот пример описывает состояние экземпляров для указанного балансировщика нагрузки.
Команда:
aws elb describe-instance-health --load-balancer-name my-load-balancer
Вывод:
{
"InstanceStates": [
{
"InstanceId": "i-207d9717",
"ReasonCode": "N/A",
"State": "InService",
"Description": "N/A"
},
{
"InstanceId": "i-afefb49b",
"ReasonCode": "N/A",
"State": "InService",
"Description": "N/A"
}
]
}
Для описания состояния экземпляра балансировщика нагрузки
Этот пример описывает состояние указанного экземпляра для указанного балансировщика нагрузки.
Команда:
aws elb describe-instance-health --load-balancer-name my-load-balancer --instances i-7299c809
Ниже приведен пример ответа для экземпляра, который регистрируется.
Вывод:
{
"InstanceStates": [
{
"InstanceId": "i-7299c809",
"ReasonCode": "ELB",
"State": "OutOfService",
"Description": "Instance registration is still in progress."
}
]
}
Ниже приведен пример ответа для неисправного экземпляра.
Вывод:
{
"InstanceStates": [
{
"InstanceId": "i-7299c809",
"ReasonCode": "Instance",
"State": "OutOfService",
"Description": "Instance has failed at least the UnhealthyThreshold number of health checks consecutively."
}
]
}
Вывод
InstanceStates -> (список)
Информация о состоянии экземпляров.
(структура)
Информация о состоянии экземпляра EC2.
InstanceId -> (строка)
State -> (строка)
Текущее состояние экземпляра.
Допустимые значения: InService | OutOfService | Unknown
ReasonCode -> (строка)
Информация о причине OutOfService экземпляров. В частности, является ли причиной Elastic Load Balancing или экземпляр.
Допустимые значения: ELB | Instance | N/A
Description -> (строка)
Описание состояния экземпляра. Эта строка может содержать одно или несколько из следующих сообщений.
N/AA transient error occurred. Please try again later.Instance has failed at least the UnhealthyThreshold number of health checks consecutively.Instance has not passed the configured HealthyThreshold number of health checks consecutively.Instance registration is still in progress.Instance is in the EC2 Availability Zone for which LoadBalancer is not configured to route traffic to.Instance is not currently registered with the LoadBalancer.Instance deregistration currently in progress.Disable Availability Zone is currently in progress.Instance is in pending state.Instance is in stopped state.Instance is in terminated state.
© Copyright 2025, Amazon Web Services. Created using Sphinx.