Spec-Zone.ru › AWS CLI v2

[ aws . autoscaling ]

describe-load-balancer-target-groups

Описание

Примечание

Данная операция API устарела и заменена на DescribeTrafficSources, которая может описывать несколько типов источников трафика. Рекомендуется использовать DetachTrafficSources для упрощения управления источниками трафика. Тем не менее, мы продолжаем поддерживать DescribeLoadBalancerTargetGroups. Вы можете использовать как оригинальную операцию API DescribeLoadBalancerTargetGroups, так и DescribeTrafficSources в одной группе Auto Scaling.

Получает информацию о целевых группах Elastic Load Balancing для указанной группы Auto Scaling.

Для определения состояния подключения целевой группы используйте элемент State в ответе. При подключении целевой группы к группе Auto Scaling начальное значение State равно Adding. Состояние переходит в Added после регистрации всех экземпляров Auto Scaling в целевой группе. Если проверки состояния Elastic Load Balancing включены для группы Auto Scaling, состояние переходит в InService после того, как по крайней мере один экземпляр Auto Scaling пройдёт проверку состояния. Когда целевая группа находится в состоянии InService, Amazon EC2 Auto Scaling может завершить и заменить любые экземпляры, которые сообщаются как неисправные. Если ни один зарегистрированный экземпляр не проходит проверки состояния, целевая группа не переходит в состояние InService.

Целевые группы также могут иметь состояние InService, если вы подключили их в вызове API CreateAutoScalingGroup. Если состояние вашей целевой группы InService, но она работает неправильно, проверьте действия масштабирования, вызвав DescribeScalingActivities, и выполните необходимые корректирующие действия.

Для справки по не пройденным проверкам состояния см. Устранение неполадок Amazon EC2 Auto Scaling: проверки состояния в руководстве Amazon EC2 Auto Scaling User Guide. Дополнительную информацию см. в разделе Использование Elastic Load Balancing для распределения трафика по экземплярам в вашей группе Auto Scaling в руководстве Amazon EC2 Auto Scaling User Guide.

Примечание

Вы можете использовать эту операцию для описания целевых групп, которые были подключены с помощью AttachLoadBalancerTargetGroups, но не для целевых групп, которые были подключены с помощью AttachTrafficSources.

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

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

Синтаксис

  describe-load-balancer-target-groups
--auto-scaling-group-name <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]

Параметры

--auto-scaling-group-name (строка)

Имя группы Auto Scaling.

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

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

Маркер для указания места начала постраничного вывода. Это значение NextToken из ранее усечённого ответа.

Примеры использования см. в разделе Постраничный вывод в руководстве AWS Command Line Interface User Guide.

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

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращённых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничный вывод в руководстве AWS Command Line Interface User Guide.

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

Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничного вывода укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничный вывод в руководстве AWS Command Line Interface User Guide.

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию можно найти в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, характерные для Unix-систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел «Использование кавычек со строками» в Руководстве пользователя AWS CLI.

Для описания групп целевых балансировщиков для группы автоматического масштабирования

Этот пример описывает группы целевых балансировщиков, присоединенные к указанной группе автоматического масштабирования.

aws autoscaling describe-load-balancer-target-groups \
    --auto-scaling-group-name my-asg

Вывод:

{
    "LoadBalancerTargetGroups": [
        {
            "LoadBalancerTargetGroupARN": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
            "State": "Added"
        }
    ]
}

Вывод

LoadBalancerTargetGroups -> (список)

Информация о группах целей.

(структура)

Описание состояния группы целей.

LoadBalancerTargetGroupARN -> (строка)

Amazon Resource Name (ARN) группы целей.

State -> (строка)

Состояние группы целей.

  • Adding - В процессе регистрации экземпляров автоматического масштабирования в группе целей.
  • Added - Все экземпляры автоматического масштабирования зарегистрированы в группе целей.
  • InService - По крайней мере, один экземпляр автоматического масштабирования прошёл проверку состояния.
  • Removing - В процессе дерегистрации экземпляров автоматического масштабирования из группы целей. Если включен режим вывода из работы подключений, Elastic Load Balancing ожидает завершения текущих запросов перед дерегистрацией экземпляров.
  • Removed - Все экземпляры автоматического масштабирования дезагрегированы из группы целей.

NextToken -> (строка)

Строка, указывающая, что ответ содержит больше элементов, чем может быть возвращено в одном ответе. Для получения дополнительных элементов укажите эту строку для параметра NextToken при запросе следующего набора элементов. Это значение равно null, когда больше элементов не осталось.

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

Spec-Zone.ru

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