list-rules
Описание
Отображает ваши правила Amazon EventBridge. Вы можете отобразить все правила или указать префикс для сопоставления с именами правил.
Максимальное количество результатов на страницу для запросов составляет 100.
ListRules не отображает целевые элементы правила. Чтобы увидеть целевые элементы, связанные с правилом, используйте ListTargetsByRule.
См. также: Документацию AWS API
list-rules является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько API-вызовов. Вы можете отключить постраничную обработку, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной обработкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Rules
Синтаксис
list-rules
[--name-prefix <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]
Параметры
--name-prefix (строка)
--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 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 (булево)
Включить отладку логов.
--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого файла, отображающего двоичный блок, 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 User Guide.
За исключением случаев, когда указано иное, во всех примерах используются правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. раздел Использование кавычек со строками в руководстве AWS CLI User Guide.
Чтобы отобразить список всех правил CloudWatch Events
Этот пример отображает все правила CloudWatch Events в регионе:
aws events list-rules
Чтобы отобразить список правил CloudWatch Events, начинающихся с определённой строки.
Этот пример отображает все правила CloudWatch Events в регионе, имя которых начинается с “Daily”:
aws events list-rules --name-prefix "Daily"
Вывод
Правила -> (список)
Правила, соответствующие заданным критериям.
(структура)
Содержит информацию о правиле в Amazon EventBridge.
Имя -> (строка)
Arn -> (строка)
EventPattern -> (строка)
Состояние -> (строка)
Состояние правила.
Допустимые значения:
-
DISABLED: Правило отключено. EventBridge не сопоставляет события с правилом. -
ENABLED: Правило включено. EventBridge сопоставляет события с правилом, *исключая* события управления Amazon Web Services, доставляемые через CloudTrail. -
ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS: Правило включено для всех событий, включая события управления Amazon Web Services, доставляемые через CloudTrail. События управления обеспечивают видимость операций управления, выполняемых над ресурсами в вашей учетной записи Amazon Web Services. Они также известны как операции управления контрольной плоскости. Дополнительную информацию см. в руководстве CloudTrail User Guide и в разделе Фильтрация событий управления от Amazon Web Services-сервисов в руководстве Amazon EventBridge User Guide. Это значение применимо только для правил на стандартной шине событий или на пользовательских шинах событий. Оно не относится к шинам событий партнёров.
Описание -> (строка)
ScheduleExpression -> (строка)
RoleArn -> (строка)
Amazon Resource Name (ARN) роли, используемой для вызова целевых элементов.
Если вы устанавливаете шину событий в другой учетной записи в качестве целевого элемента, и эта учетная запись предоставила разрешения вашей учетной записи через организацию вместо прямого указания идентификатора учетной записи, вы должны указать RoleArn с соответствующими разрешениями в структуре Target, а не здесь в этом параметре.
ManagedBy -> (строка)
EventBusName -> (строка)
NextToken -> (строка)
Токен, указывающий на то, что доступны дополнительные результаты. Если больше результатов нет, токен в ответе не включён.
Значение nextToken является уникальным маркером постраничной обработки для каждой страницы. Чтобы получить следующую страницу результатов, повторите вызов, используя возвращенный токен. Не изменяйте другие аргументы.
Использование истекшего маркера постраничной обработки приводит к ошибке HTTP 400 InvalidToken.
© Copyright 2025, Amazon Web Services. Created using Sphinx.