[ aws . vpc-lattice ]
list-targets
Описание
Отображает целевые элементы для группы целевых элементов. По умолчанию включены все целевые элементы. Вы можете использовать этот API для проверки состояния здоровья целевых элементов. Также можно фильтровать результаты по целевому элементу.
См. также: Документацию API AWS
list-targets является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлечь данные из результатов следующих выражений запроса: items
Синтаксис
list-targets
--target-group-identifier <value>
[--targets <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]
Параметры
--target-group-identifier (строка)
--targets (список)
Целевые элементы.
(структура)
Описывает целевой элемент.
id -> (строка)
INSTANCE, это идентификатор экземпляра. Если тип группы целевых элементов — IP, это IP-адрес. Если тип группы целевых элементов — LAMBDA, это ARN функции Lambda. Если тип группы целевых элементов — ALB, это ARN балансировщика нагрузки приложений.port -> (целое число)
Сокращенный синтаксис:
id=string,port=integer ...
Синтаксис JSON:
[
{
"id": "string",
"port": integer
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, указанному в --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные данные с помощью значения, предоставленного в JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер для указания места начала постраничного вывода. Это NextToken из ранее усечённого ответа.
Примеры использования см. в разделе Постраничный вывод в руководстве пользователя AWS CLI.
--page-size (целое число)
Размер каждой страницы для получения данных в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничный вывод в руководстве пользователя AWS CLI.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Чтобы продолжить постраничный вывод, предоставьте значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничный вывод в руководстве пользователя AWS CLI.
--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.
Для отображения целевых элементов для группы целевых элементов
Следующий пример list-targets показывает целевые элементы для указанной группы целевых элементов.
aws vpc-lattice list-targets \
--target-group-identifier tg-0eaa4b9ab4EXAMPLE
Вывод:
{
"items": [
{
"id": "i-07dd579bc5EXAMPLE",
"port": 443,
"status": "HEALTHY"
},
{
"id": "i-047b3c9078EXAMPLE",
"port": 443,
"reasonCode": "HealthCheckFailed",
"status": "UNHEALTHY"
}
]
}
Дополнительную информацию см. в разделе Группы целевых элементов в руководстве пользователя Amazon VPC Lattice.
Вывод
items -> (список)
Информация о целевых элементах.
(структура)
Сводная информация о целевом элементе.
id -> (строка)
INSTANCE, это идентификатор экземпляра. Если тип группы целевых элементов — IP, это IP-адрес. Если тип целевого элемента — LAMBDA, это ARN функции Lambda. Если тип целевого элемента — ALB, это ARN балансировщика нагрузки приложений.port -> (целое число)
reasonCode -> (строка)
status -> (строка)
Состояние целевого элемента.
-
DRAINING: Целевой элемент дерегистрируется. Новые подключения к этому целевому элементу не отправляются, пока текущие подключения не будут завершены. Время завершения по умолчанию составляет 5 минут. -
UNAVAILABLE: Мониторинг работоспособности недоступен для группы целевых элементов. -
HEALTHY: Целевой элемент работоспособен. -
UNHEALTHY: Целевой элемент неработоспособен. -
INITIAL: Выполняются начальные проверки работоспособности целевого элемента. -
UNUSED: Группа целевых элементов не используется в сервисе.
nextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.