[Документация Yandex Cloud](../../../../index.md) > [Yandex Serverless Integrations](../../../index.md) > [Пошаговые инструкции](../../index.md) > EventRouter > Управление правилом > Создать правило > Message Queue # Создать правило с приемником Yandex Message Queue {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) перейдите в каталог, в котором хотите создать [правило](../../../concepts/eventrouter/rule.md). 1. Перейдите в сервис **Serverless Integrations**. 1. На панели слева нажмите ![image](../../../../_assets/console-icons/object-align-center-vertical.svg) **EventRouter**. 1. Выберите нужную [шину](../../../concepts/eventrouter/bus.md). 1. Перейдите на вкладку ![image](../../../../_assets/console-icons/target-dart.svg) **Правила**. 1. В правом верхнем углу нажмите **Создать правило**. 1. (Опционально) Раскройте блок **Фильтр** и введите [jq-шаблон](https://jqlang.github.io/jq/manual/) для [фильтрации](../../../concepts/eventrouter/rule.md#filter) событий. 1. В блоке **Приёмники** нажмите **Добавить** и настройте приемник: 1. Укажите тип приемника `Yandex Message Queue`. 1. Выберите [каталог](../../../../resource-manager/concepts/resources-hierarchy.md#folder) и [очередь](../../../../message-queue/concepts/queue.md), в которую будут отправляться сообщения, соответствующие правилу. 1. Выберите [сервисный аккаунт](../../../../iam/concepts/users/service-accounts.md), которому назначена [роль](../../../../message-queue/security/index.md#ymq-writer) `ymq.writer` или выше на выбранную очередь, или [создайте](../../../../iam/operations/sa/create.md) новый. 1. (Опционально) Нажмите ![plus](../../../../_assets/console-icons/plus.svg) **Настройки повторной отправки сообщений** и укажите: * **Количество попыток** — количество повторных попыток отправки сообщений, которые будут сделаны, прежде чем EventRouter отправит сообщения в Dead Letter Queue (DLQ). Допустимые значения от 0 до 1 000, значение по умолчанию — 3. * **Интервал, ч** — время в часах, через которое будет сделана повторная попытка отправить сообщения, если текущая завершилась неуспешно. Допустимые значения от 0 до 60 часов, значение по умолчанию — 10 минут. 1. (Опционально) Раскройте поле **Шаблон** и введите [jq-шаблон](https://jqlang.github.io/jq/manual/) для преобразования событий. Если шаблон не указан, событие не преобразовывается. 1. (Опционально) Раскройте блок **Настройки обработки недоставленных сообщений**: 1. Укажите тип обработчика `Yandex Message Queue`. 1. Выберите каталог и очередь DLQ, в которую будут перенаправляться сообщения, которые не смог обработать приемник. 1. Выберите сервисный аккаунт, которому назначена [роль](../../../../message-queue/security/index.md#ymq-writer) `ymq.writer` или выше на выбранную очередь DLQ, или [создайте](../../../../iam/operations/sa/create.md) новый. 1. Раскройте блок **Дополнительные параметры**: 1. Введите имя и описание правила. Требования к имени: * Длина — от 3 до 63 символов. * Может содержать строчные и заглавные буквы латинского и русского алфавита, цифры, дефисы, подчеркивания и пробелы. * Первый символ должен быть буквой. Последний символ не может быть дефисом, подчеркиванием или пробелом. 1. (Опционально) Добавьте метки: * Нажмите **Добавить метку**. * Введите метку в формате `ключ: значение`. * Нажмите **Enter**. 1. (Опционально) Включите защиту от удаления. Пока опция включена, удалить правило невозможно. 1. Нажмите **Создать**. - CLI {#cli} Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../../cli/quickstart.md#install). По умолчанию используется каталог, указанный при [создании](../../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа. 1. Посмотрите описание команды CLI для создания [правила](../../../concepts/eventrouter/rule.md): ```bash yc serverless eventrouter rule create --help ``` 1. Создайте правило с приемником Yandex Message Queue: ```bash yc serverless eventrouter rule create \ --bus-id <идентификатор_шины> \ --filter '' \ --ymq-target \ queue-arn=,\ service-account-id=<идентификатор_сервисного_аккаунта_очереди>,\ retry-attempts=<количество_попыток>,\ maximum-age=<интервал>,\ transformer=,\ dlq-arn=<очередь_DLQ>,\ dlq-service-account-id=<идентификатор_сервисного_аккаунта_DLQ> \ --name <имя_правила> \ --description "<описание_правила>" \ --deletion-protection \ --labels <список_меток> ``` Где: * `--bus-id` — идентификатор [шины](../../../concepts/eventrouter/bus.md) EventRouter. * `--filter` — [jq-шаблон](https://jqlang.github.io/jq/manual/) для [фильтрации](../../../concepts/eventrouter/rule.md#filter) событий. * `--ymq-target` — параметр для настройки приемника с типом `Yandex Message Queue` и его свойства: * `queue-arn` — ARN [очереди](../../../../message-queue/concepts/queue.md), в которую будут отправляться сообщения, соответствующие правилу. * `service-account-id` — идентификатор [сервисного аккаунта](../../../../iam/concepts/users/service-accounts.md), которому назначена [роль](../../../../message-queue/security/index.md#ymq-writer) `ymq.writer` или выше на выбранную очередь. * `retry-attempts` — количество повторных попыток отправки сообщений, которые будут сделаны, прежде чем EventRouter отправит сообщения в Dead Letter Queue (DLQ). Допустимые значения от 0 до 1 000. Необязательный параметр. * `maximum-age` — время, через которое будет сделана повторная попытка отправить сообщения, если текущая завершилась неуспешно. Допустимые значения от 0 до 60 часов. Необязательный параметр. * `transformer` — [jq-шаблон](https://jqlang.github.io/jq/manual/) для преобразования событий. Если шаблон не указан, событие не преобразовывается. Необязательный параметр. * `dlq-arn` — ARN очереди DLQ в которую будут перенаправляться сообщения, которые не смог обработать приемник. Необязательный параметр. * `dlq-service-account-id` — идентификатор сервисного аккаунта, которому назначена [роль](../../../../message-queue/security/index.md#ymq-writer) `ymq.writer` или выше на выбранную очередь DLQ. Необязательный параметр. * `--name` — имя правила. Требования к имени: * Длина — от 3 до 63 символов. * Может содержать строчные и заглавные буквы латинского и русского алфавита, цифры, дефисы, подчеркивания и пробелы. * Первый символ должен быть буквой. Последний символ не может быть дефисом, подчеркиванием или пробелом. * `--description` — описание правила. Необязательный параметр. * `--deletion-protection` — защита от удаления правила. По умолчанию защита выключена. Пока опция включена, удалить правило невозможно. Чтобы отключить защиту от удаления, укажите параметр `--no-deletion-protection`. Необязательный параметр. * `--labels` — список меток. Необязательный параметр. Можно указать одну или несколько меток через запятую в формате `<ключ1>=<значение1>,<ключ2>=<значение2>`. Результат: ```text id: f66vfpjrkc35******** bus_id: f66epjc9llqt******** folder_id: b1g681qpemb4******** cloud_id: b1gia87mbaom******** created_at: "2025-02-26T14:04:47.710918Z" name: new-rule description: created via cli labels: owner: admin version: beta filter: jq_filter: .firstName == "Ivan" targets: - ymq: queue_arn: yrn:yc:ymq:kz1:b1g681qpemb4********:dlq-42 service_account_id: ajelprpohp7r******** transformer: jq_transformer: . retry_settings: retry_attempts: "3" maximum_age: 600s dead_letter_queue: queue_arn: yrn:yc:ymq:kz1:b1g681qpemb4********:dlq-42 service_account_id: ajelprpohp7r******** status: ENABLED deletion_protection: true status: ENABLED ``` - Terraform {#tf} [Terraform](https://www.terraform.io/) позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить. Terraform распространяется под лицензией [Business Source License](https://github.com/hashicorp/terraform/blob/main/LICENSE), а [провайдер Yandex Cloud для Terraform](https://github.com/yandex-cloud/terraform-provider-yandex) — под лицензией [MPL-2.0](https://www.mozilla.org/en-US/MPL/2.0/). Подробная информация о ресурсах провайдера в документации на сайте [Terraform](https://www.terraform.io/docs/providers/yandex/index.html) или в [зеркале](../../../../terraform/index.md). Если у вас еще нет Terraform, [установите его и настройте провайдер Yandex Cloud](../../../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform). Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, [аутентифицируйтесь](../../../../terraform/authentication.md) соответствующим способом. Чтобы создать [правило](../../../concepts/eventrouter/rule.md) с приемником Yandex Message Queue: 1. Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать: ```hcl resource "yandex_serverless_eventrouter_rule" "example_rule" { bus_id = "<идентификатор_шины>" jq_filter = "" ymq { queue_arn = "" service_account_id = "<идентификатор_сервисного_аккаунта>" } name = "<имя_правила>" description = "<описание_правила>" labels = { <ключ_1> = "<значение_1>" <ключ_2> = "<значение_2>" ... <ключ_n> = "<значение_n>" } } ``` Где: * `bus_id` — идентификатор [шины](../../../concepts/eventrouter/bus.md) EventRouter. * `jq_filter` — [jq-шаблон](https://jqlang.github.io/jq/manual/) для [фильтрации](../../../concepts/eventrouter/rule.md#filter) событий. * `ymq` — блок для настройки приемника с типом `Yandex Message Queue` и его параметры: * `queue_arn` — ARN [очереди](../../../../message-queue/concepts/queue.md), в которую будут отправляться сообщения, соответствующие правилу. * `service_account_id` — идентификатор [сервисного аккаунта](../../../../iam/concepts/users/service-accounts.md), которому назначена [роль](../../../../message-queue/security/index.md#ymq-writer) `ymq.writer` или выше на выбранную очередь. * `name` — имя правила. Требования к имени: * Длина — от 3 до 63 символов. * Может содержать строчные и заглавные буквы латинского и русского алфавита, цифры, дефисы, подчеркивания и пробелы. * Первый символ должен быть буквой. Последний символ не может быть дефисом, подчеркиванием или пробелом. * `description` — описание правила. Необязательный параметр. * `labels` — список меток. Метки задаются в формате `<ключ> = "<значение>"`. Необязательный параметр. Подробнее о параметрах ресурса `yandex_serverless_eventrouter_rule` в [документации провайдера](../../../../terraform/resources/serverless_eventrouter_rule.md). 1. Создайте ресурсы: 1. В терминале перейдите в директорию с конфигурационным файлом. 1. Проверьте корректность конфигурации с помощью команды: ```bash terraform validate ``` Если конфигурация является корректной, появится сообщение: ```bash Success! The configuration is valid. ``` 1. Выполните команду: ```bash terraform plan ``` В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет. 1. Примените изменения конфигурации: ```bash terraform apply ``` 1. Подтвердите изменения: введите в терминале слово `yes` и нажмите **Enter**. Terraform создаст все требуемые ресурсы. Проверить появление ресурсов можно в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [CLI](../../../../cli/index.md): ```bash yc serverless eventrouter rule list ``` - API {#api} Чтобы создать [правило](../../../concepts/eventrouter/rule.md) с приемником Yandex Message Queue, воспользуйтесь методом REST API [Create](../../../eventrouter/api-ref/Rule/create.md) для ресурса [rule](../../../eventrouter/api-ref/Rule/index.md) или вызовом gRPC API [rule/Create](../../../eventrouter/api-ref/grpc/Rule/create.md). {% endlist %} По умолчанию правило создается включенным. Чтобы события, которые соответствуют правилу, перестали перенаправляться в приемник, [выключите](disable.md) правило.