[ aws . codestar-notifications ]
создать-правило-уведомления
Описание
Создаёт правило уведомления для ресурса. Правило определяет события, о которых вы хотите получать уведомления, и целевые адреса (например, темы чат-бота или клиенты чат-бота, настроенные для Slack), где вы хотите их получать.
См. также: Документацию API AWS
Синтаксис
create-notification-rule
--name <value>
--event-type-ids <value>
--resource <value>
--targets <value>
--detail-type <value>
[--client-request-token <value>]
[--tags <value>]
[--status <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]
Параметры
--name (строка)
--event-type-ids (список)
Список типов событий, связанных с этим правилом уведомлений. Список разрешенных событий см. в EventTypeSummary .
(строка)
Синтаксис:
"string" "string" ...
--resource (строка)
--targets (список)
Список Amazon Resource Names (ARN) тем Amazon Simple Notification Service и клиентов чат-бота, которые нужно связать с правилом уведомлений.
(структура)
Информация о темах чат-бота или клиентах чат-бота, связанных с правилом уведомлений.
TargetType -> (строка)
Тип целевого объекта. Может быть темой чат-бота или клиентом чат-бота.
- Темы чат-бота задаются как
SNS. - Клиенты чат-бота задаются как
AWSChatbotSlack.
TargetAddress -> (строка)
Сокращённый синтаксис:
TargetType=string,TargetAddress=string ...
Синтаксис JSON:
[
{
"TargetType": "string",
"TargetAddress": "string"
}
...
]
--detail-type (строка)
Уровень детализации, который нужно включить в уведомления для данного ресурса. BASIC будет включать только содержимое события, как оно отображается в Amazon CloudWatch. FULL будет включать любую дополнительную информацию, предоставленную AWS CodeStar Notifications и/или сервисом для ресурса, для которого создаётся уведомление.
Возможные значения:
BASICFULL
--client-request-token (строка)
Уникальный, сгенерированный клиентом маркер идемпотенции, который, при предоставлении в запросе, гарантирует, что запрос не может быть повторён с изменённым параметром. Если получен запрос с теми же параметрами и маркер включён, запрос возвращает информацию об исходном запросе, который использовал этот маркер.
Примечание
Инструменты AWS SDK заполняют маркеры запросов клиента. Если вы используете инструменты AWS SDK, маркер идемпотенции создаётся для вас.--tags (словарь)
Список тегов для применения к этому правилу уведомлений. Имена ключей не могут начинаться с «aws «.
ключ -> (строка)
значение -> (строка)
Сокращённый синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--status (строка)
Состояние правила уведомления. Значение по умолчанию — ENABLED . Если состояние установлено в DISABLED , уведомления для правила уведомления не отправляются.
Возможные значения:
ENABLEDDISABLED
--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 .
Создание правила уведомления
Следующий create-notification-rule пример использует файл JSON с именем rule.json для создания правила уведомления под названием MyNotificationRule для репозитория под названием MyDemoRepo в указанной учётной записи AWS. Уведомления с типом детализации FULL отправляются в указанную целевую тему Amazon SNS при создании веток и тегов.
aws codestar-notifications create-notification-rule \
--cli-input-json file://rule.json
Содержимое rule.json:
{
"Name": "MyNotificationRule",
"EventTypeIds": [
"codecommit-repository-branches-and-tags-created"
],
"Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
"Targets": [
{
"TargetType": "SNS",
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}
],
"Status": "ENABLED",
"DetailType": "FULL"
}
Вывод:
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
Для получения дополнительной информации см. Создание правила уведомления в Руководстве пользователя консоли AWS Developer Tools.
Вывод
Arn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.
|
|