list-targets-by-rule
Описание
Отображает целевые объекты, назначенные указанному правилу.
Максимальное количество результатов на страницу для запросов — 100.
См. также: Документация API AWS
list-targets-by-rule — это операция с постраничной выборкой. Для получения всего набора результатов могут быть отправлены несколько API-запросов. Вы можете отключить постраничную выборку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной выборкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Targets
Синтаксис
list-targets-by-rule
--rule <value>
[--event-bus-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]
Параметры
--rule (строка)
--event-bus-name (строка)
--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
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Использовать указанный регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- on
- off
- auto
--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.
Чтобы отобразить все целевые объекты для правила CloudWatch Events
В этом примере отображаются все целевые объекты правила с именем DailyLambdaFunction:
aws events list-targets-by-rule --rule "DailyLambdaFunction"
Выходные данные
Цели -> (список)
Цели, назначенные правилу.
(структура)
Цели — это ресурсы, которые вызываются при срабатывании правила. Полный список служб и ресурсов, которые можно задать как цель, см. в разделе PutTargets.
Если вы задаёте целевой шину событий другого аккаунта и этот аккаунт предоставил разрешение вашему аккаунту через организацию, а не напрямую по идентификатору аккаунта, то вы должны указать RoleArn с соответствующими разрешениями в структуре Target. Дополнительные сведения см. в руководстве пользователя Amazon EventBridge, раздел «Пересылка и получение событий между аккаунтами Amazon Web Services».
Id -> (строка)
Arn -> (строка)
RoleArn -> (строка)
Input -> (строка)
InputPath -> (строка)
InputTransformer -> (структура)
Настройки, позволяющие предоставить пользовательский ввод цели на основе определённых данных события. Вы можете извлечь одну или несколько пар «ключ-значение» из события и затем использовать эти данные для отправки настроенного ввода цели.
InputPathsMap -> (отображение)
Отображение JSON-путей, которые необходимо извлечь из события. Затем вы можете вставить их в шаблон в InputTemplate, чтобы получить желаемый вывод, который будет отправлен цели.
InputPathsMap — это массив пар «ключ-значение», где каждое значение является допустимым JSON-путем. Вы можете использовать до 100 пар «ключ-значение». Необходимо использовать обозначение JSON с точкой, а не в квадратных скобках.Ключи не могут начинаться с «Amazon Web Services».
ключ -> (строка)
значение -> (строка)
InputTemplate -> (строка)
Шаблон ввода, в котором вы указываете заполнитель, который будет заполнен значениями ключей из InputPathsMap, чтобы настроить данные, отправленные цели. Заключите каждое значение InputPathsMaps в квадратные скобки: <значение>.
Если InputTemplate представляет собой JSON-объект (в фигурных скобках), применяются следующие ограничения:
- Заполнитель нельзя использовать в качестве ключа объекта.
В следующем примере показан синтаксис использования InputPathsMap и InputTemplate.
"InputTransformer":
{
"InputPathsMap": {"instance": "$.detail.instance","status": "$.detail.status"},
"InputTemplate": "<instance> is in state <status>"
}
Чтобы включить в InputTemplate кавычки внутри JSON-строки, экранируйте каждую кавычку обратной косой чертой, как в следующем примере:
"InputTransformer":
{
"InputPathsMap": {"instance": "$.detail.instance","status": "$.detail.status"},
"InputTemplate": "<instance> is in state \"<status>\""
}
InputTemplate также может быть допустимым JSON с переменными в кавычках или без них, как в следующем примере:
"InputTransformer":
{
"InputPathsMap": {"instance": "$.detail.instance","status": "$.detail.status"},
"InputTemplate": '{"myInstance": <instance>,"myStatus": "<instance> is in state \"<status>\""}'
}
KinesisParameters -> (структура)
Настраиваемый параметр, который можно использовать для управления назначением раздела, когда целевой объект — поток данных Kinesis. Если этот параметр не указан, по умолчанию используется eventId в качестве ключа раздела.
PartitionKeyPath -> (строка)
RunCommandParameters -> (структура)
Параметры, используемые при использовании правила для вызова Amazon EC2 Run Command.
RunCommandTargets -> (список)
В настоящее время мы поддерживаем включение только одного блока RunCommandTarget, который указывает либо массив InstanceIds, либо тег.
(структура)
Информация об экземплярах EC2, которым необходимо отправить команду, указанная в виде пар «ключ-значение». Каждый блок RunCommandTarget может содержать только один ключ, но этот ключ может указывать несколько значений.
Ключ -> (строка)
tag: ключ_тега, либо InstanceIds.Значения -> (список)
Если Key — tag: ключ_тега, Values — список значений тегов. Если Key — InstanceIds, то Values — список идентификаторов экземпляров Amazon EC2.
(строка)
EcsParameters -> (структура)
Содержит определение задачи Amazon ECS и количество задач, которые будут использоваться, если целевой объект — задача Amazon ECS. Дополнительную информацию о задачах Amazon ECS см. в разделе Определения задач в руководстве разработчика Amazon EC2 Container Service.
TaskDefinitionArn -> (string)
TaskCount -> (integer)
TaskDefinition. По умолчанию значение равно 1.LaunchType -> (string)
FARGATE поддерживается только в регионах, где поддерживается Fargate с Amazon ECS. Дополнительную информацию см. в разделе Fargate в Amazon ECS в руководстве разработчика Amazon Elastic Container Service.NetworkConfiguration -> (structure)
Используйте эту структуру, если задача Amazon ECS использует режим сети awsvpc. Эта структура определяет подсети VPC и группы безопасности, связанные с задачей, а также использование публичного IP-адреса. Эта структура необходима, если LaunchType FARGATE, так как для задач Fargate требуется режим awsvpc.
Если вы укажете NetworkConfiguration, когда целевая задача ECS не использует режим сети awsvpc, задача завершится с ошибкой.
awsvpcConfiguration -> (structure)
Используйте эту структуру для указания подсетей VPC и групп безопасности для задачи, а также для указания использования публичного IP-адреса. Эта структура актуальна только для задач ECS, использующих режим сети awsvpc.
Subnets -> (list)
Определяет подсети, связанные с задачей. Все эти подсети должны находиться в одной VPC. Вы можете указать до 16 подсетей.
(string)
SecurityGroups -> (list)
Определяет группы безопасности, связанные с задачей. Все эти группы безопасности должны находиться в одной VPC. Вы можете указать до пяти групп безопасности. Если вы не укажете группу безопасности, будет использоваться группа безопасности по умолчанию для VPC.
(string)
AssignPublicIp -> (string)
ENABLED только когда LaunchType в EcsParameters установлено в значение FARGATE.PlatformVersion -> (string)
Определяет версию платформы для задачи. Указывайте только числовую часть версии платформы, например, 1.1.0.
Эта структура используется только если LaunchType равно FARGATE. Дополнительную информацию о допустимых версиях платформы см. в разделе Версии платформы Fargate в руководстве разработчика Amazon Elastic Container Service.
Group -> (string)
CapacityProviderStrategy -> (list)
Стратегия поставщика емкости для использования в задаче.
Если указана capacityProviderStrategy, параметр launchType должен быть опущен. Если не указана capacityProviderStrategy или launchType, используется defaultCapacityProviderStrategy для кластера.
(structure)
Подробности стратегии поставщика емкости. Дополнительную информацию см. в разделе CapacityProviderStrategyItem в справочнике по API Amazon ECS.
capacityProvider -> (string)
weight -> (integer)
base -> (integer)
EnableECSManagedTags -> (boolean)
EnableExecuteCommand -> (boolean)
PlacementConstraints -> (list)
Массив объектов ограничений размещения для использования в задаче. Вы можете указать до 10 ограничений на задачу (включая ограничения в определении задачи и указанные во время выполнения).
(structure)
Объект, представляющий ограничение размещения задачи. Дополнительную информацию см. в разделе Ограничения размещения задач в руководстве разработчика Amazon Elastic Container Service.
type -> (string)
expression -> (string)
distinctInstance. Дополнительную информацию см. в разделе Язык запросов кластера в руководстве разработчика Amazon Elastic Container Service.PlacementStrategy -> (list)
Объекты стратегии размещения для использования в задаче. Вы можете указать не более пяти правил стратегии на задачу.
(structure)
Стратегия размещения задач для задачи или службы. Дополнительную информацию см. в руководстве разработчика Amazon Elastic Container Service.
type -> (string)
field -> (string)
PropagateTags -> (string)
ReferenceId -> (string)
Tags -> (list)
Метаданные, которые вы применяете к задаче, чтобы помочь вам категоризировать и организовать их. Каждый тег состоит из ключа и необязательного значения, которые вы определяете. Дополнительную информацию см. в разделе RunTask в справке по API Amazon ECS.
(structure)
Пара ключ-значение, связанная с ресурсом Amazon Web Services. В EventBridge правила и шины событий поддерживают тегирование.
Key -> (string)
Value -> (string)
BatchParameters -> (structure)
Если целевой объект — задание Batch, это содержит определение задания, имя задания и другие параметры. Дополнительную информацию см. в разделе Задачи в руководстве пользователя Batch.
JobDefinition -> (string)
JobName -> (string)
ArrayProperties -> (structure)
Свойства массива для отправленного задания, такие как размер массива. Размер массива может быть от 2 до 10 000. Если вы указываете свойства массива для задания, оно становится заданием массива. Этот параметр используется только если целевой объект — задание Batch.
Size -> (integer)
RetryStrategy -> (structure)
Стратегия повторных попыток для невыполненных заданий, если целевой объект — задание Batch. Стратегия повторных попыток — это количество попыток повтора невыполненного выполнения задания. Допустимые значения — 1–10. Когда вы указываете стратегию повторных попыток здесь, она переопределяет стратегию повторных попыток, определенную в определении задания.
Attempts -> (integer)
SqsParameters -> (structure)
Содержит идентификатор группы сообщений, который следует использовать, когда целевой объект — очередь FIFO.
Если вы указываете очередь FIFO SQS в качестве целевого объекта, очередь должна иметь включенную дедупликацию на основе содержимого.
MessageGroupId -> (string)
HttpParameters -> (structure)
Содержит параметры HTTP, которые следует использовать, когда целевой объект — конечная точка API Gateway или EventBridge ApiDestination.
Если вы указываете API API Gateway или EventBridge ApiDestination в качестве целевого объекта, вы можете использовать этот параметр для указания заголовков, параметров пути и ключей/значений строки запроса в качестве части запроса вызова целевого объекта. Если вы используете ApiDestinations, соответствующий Connection также может иметь эти значения. В случае конфликтующих ключей значения из Connection имеют приоритет.
PathParameterValues -> (list)
Значения параметров пути, которые следует использовать для заполнения подстановочных знаков пути API Gateway API или EventBridge ApiDestination («*»).
(string)
HeaderParameters -> (map)
Заголовки, которые необходимо отправлять в запросе вызова API Gateway API или EventBridge ApiDestination.
key -> (string)
value -> (string)
QueryStringParameters -> (map)
Ключи/значения строки запроса, которые необходимо отправлять в запросе вызова API Gateway API или EventBridge ApiDestination.
key -> (string)
value -> (string)
RedshiftDataParameters -> (structure)
Содержит параметры Amazon Redshift Data API, которые следует использовать, когда целевой объект — кластер Amazon Redshift.
Если вы указали кластер Amazon Redshift в качестве целевого объекта, вы можете использовать эти параметры для указания параметров вызова Amazon Redshift Data API ExecuteStatement на основе событий EventBridge.
SecretManagerArn -> (строка)
Database -> (строка)
DbUser -> (строка)
Sql -> (строка)
StatementName -> (строка)
WithEvent -> (логическое значение)
Sqls -> (список)
Один или несколько SQL-запросов для выполнения. SQL-запросы выполняются как единая транзакция. Они выполняются последовательно в порядке массива. Последующие SQL-запросы не начинаются, пока предыдущий запрос в массиве не завершится. Если какой-либо SQL-запрос завершится ошибкой, то из-за выполнения в одной транзакции вся работа будет отменена.
(строка)
SageMakerPipelineParameters -> (структура)
Содержит параметры конвейера построения моделей SageMaker AI для запуска выполнения конвейера построения моделей SageMaker AI.
Если вы указали конвейер построения моделей SageMaker AI в качестве целевого объекта, вы можете использовать эти параметры для указания параметров запуска выполнения конвейера на основе событий EventBridge.
PipelineParameterList -> (список)
Список имен параметров и значений для запуска выполнения конвейера построения моделей SageMaker AI.
(структура)
Пара имя/значение параметра для запуска выполнения конвейера построения моделей SageMaker AI.
Name -> (строка)
Value -> (строка)
DeadLetterConfig -> (структура)
DeadLetterConfig, определяющий целевую очередь для отправки событий очереди с сообщениями об ошибках.
Arn -> (строка)
RetryPolicy -> (структура)
Настройка политики повторных попыток для очереди с сообщениями об ошибках.
MaximumRetryAttempts -> (целое число)
MaximumEventAgeInSeconds.MaximumEventAgeInSeconds -> (целое число)
AppSyncParameters -> (структура)
Содержит GraphQL-операцию, подлежащую разбору и выполнению, если целевой объект события — API AppSync.
GraphQLOperation -> (строка)
GraphQL-операция; то есть запрос, мутация или подписка, подлежащие разбору и выполнению службой GraphQL.
Дополнительную информацию см. в разделе Операции в руководстве пользователя AppSync.
NextToken -> (строка)
Маркер, указывающий на наличие дополнительных результатов. Если больше результатов нет, маркер не включается в ответ.
Значение nextToken — уникальный маркер постраничной навигации для каждой страницы. Чтобы получить следующую страницу результатов, выполните вызов еще раз с использованием возвращенного маркера. Не изменяйте другие аргументы.
Использование истекшего маркера постраничной навигации приводит к ошибке HTTP 400 InvalidToken.
© Copyright 2025, Amazon Web Services. Created using Sphinx.