As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Criação de regras usando o Advanced Builder
Para agir em relação aos eventos recebidos pela Amazon EventBridge, você pode criar [regras](eb-rules.md). Quando um evento corresponde ao [padrão de evento](eb-event-patterns.md) definido em sua regra, EventBridge envia o evento para o [destino](eb-targets.md) especificado e aciona a ação definida na regra.
As etapas a seguir explicam como criar uma regra EventBridge usada para combinar eventos à medida que eles são enviados para o barramento de eventos especificado.
**Topics**
+ [Defina a regra](#eb-create-rule-define)
+ [Criar o padrão de eventos](#eb-create-rule-event-pattern)
+ [Selecione destinos](#eb-create-rule-target)
+ [Configurar tags e regra de revisão](#eb-create-rule-review)
## Defina a regra
Primeiro, insira um nome e uma descrição para a regra para identificá-la. Também é preciso definir o barramento de eventos em que sua regra procura eventos que correspondam a um padrão de eventos.
**Para definir os detalhes da regra**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Regras**.
1. Escolha **Create rule**.
1. Na página de seleção do criador de regras, escolha **Construtor avançado**.
O Advanced Builder usa padrões e configurações JSON para regras e destinos. Para usar a tela visual em vez disso, consulte [Criação de regras (Enhanced Builder)](eb-create-rule-visual.md).
1. Informe um **Nome** para a regra e, opcionalmente, uma **Descrição** para a regra.
Uma regra não pode ter o mesmo nome de outra regra no mesmo barramento de eventos Região da AWS e no mesmo.
1. Em **Barramento de eventos**, selecione o barramento de eventos para associar com essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, escolha **Barramento de eventos padrão da AWS **. Quando um AWS service (Serviço da AWS) em sua conta emite um evento, ele sempre vai para o ônibus de eventos padrão da sua conta.
1. Em **Rule type**, escolha **Rule with an event pattern**.
1. Escolha **Próximo**.
## Criar o padrão de eventos
Em seguida, crie o padrão do evento. Para fazer isso, especifique a origem do evento, escolha a base para o padrão do evento e defina os atributos e valores aos quais corresponder. Também é possível gerar o padrão de evento em JSON e testá-lo em um evento de amostra.
**Para criar o padrão de eventos**
1. Em **Origem do evento**, escolha **AWS eventos ou eventos de EventBridge parceiros**.
1. (Opcional) Na seção **Eventos de amostra**, escolha um **Tipo de evento de amostra** com o qual deseja testar seu padrão de evento.
Os seguintes tipos de eventos estão disponíveis:
+ **AWS eventos** — Selecione entre os eventos emitidos pelo suporte Serviços da AWS.
+ **EventBridge eventos de parceiros** — selecione entre os eventos emitidos por serviços terceirizados que oferecem suporte EventBridge, como o Salesforce.
+ **Inserir o meu próprio**: insira o seu próprio evento em texto JSON.
Você também pode usar um evento AWS ou um evento de um parceiro como ponto de partida para criar seu próprio evento personalizado.
1. Selecione **AWS eventos ou eventos** de **EventBridge parceiros**.
1. Use o menu suspenso **Exemplos de eventos** para selecionar o evento que deseja usar como ponto de partida para seu evento personalizado.
EventBridge exibe o evento de amostra.
1. Selecione **Copiar**.
1. Selecione **Inserir meu próprio** para o **Tipo de evento**.
1. Exclua a estrutura de eventos de amostra no painel de edição JSON e cole o evento AWS ou o evento do parceiro em seu lugar.
1. Edite o JSON do evento para criar seu próprio evento de amostra.
1. Escolha um **Método de criação**. Você pode criar um padrão de evento a partir de um EventBridge esquema ou modelo, ou pode criar um padrão de evento personalizado.
------
#### [ Existing schema ]
Para usar um EventBridge esquema existente para criar o padrão de evento, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, selecione **Usar esquema**.
1. Na seção **Padrão de evento**, em **Tipo de esquema**, selecione **Selecionar esquema do registro do esquema**.
1. Em **Registro do esquema**, escolha a caixa suspensa e insira o nome de um registro do esquema, como `aws.events`. Também é possível selecionar uma opção na lista suspensa que aparece.
1. Em **Esquema**, escolha a caixa suspensa e insira o nome do esquema a ser usado. Por exemplo, .`aws.s3@ObjectDeleted` Também é possível selecionar uma opção na lista suspensa que aparece.
1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.
1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
EventBridge exibe uma caixa de mensagem informando se o evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
#### [ Custom schema ]
Para escrever um esquema personalizado e convertê-lo em um padrão de evento, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, escolha **Usar esquema**.
1. Na seção **Padrão de evento**, em **Tipo de esquema**, escolha **Inserir esquema**.
1. Insira o seu esquema na caixa de texto. É preciso formatar o esquema como texto JSON válido.
1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.
1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
EventBridge exibe uma caixa de mensagem informando se o evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
#### [ Event pattern ]
Para escrever um padrão de evento personalizado no formato JSON, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, escolha **Padrão personalizado (editor JSON)**.
1. Em **Padrão de evento**, insira seu padrão de evento personalizado em texto formatado em JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
EventBridge exibe uma caixa de mensagem informando se o evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
+ **Formulário de padrão de evento**: abre o padrão de evento no Criador de padrões. Se o padrão não puder ser renderizado no Pattern Builder no estado em que se encontra, EventBridge avisa você antes de abrir o Pattern Builder.
------
1. Escolha **Próximo**.
## Selecione destinos
Escolha um ou mais destinos para receber eventos que correspondam ao padrão especificado. Os alvos podem incluir um barramento de EventBridge eventos, destinos de EventBridge API, incluindo parceiros de SaaS, como Salesforce, ou outros. AWS service (Serviço da AWS)
**Para selecionar destinos**
1. Para **Tipo de destino**, escolha um dos seguintes tipos de destino:
------
#### [ Event bus ]
1. Selecione o **ônibus EventBridge do evento**.
1. Escolha o barramento de eventos a ser usado como o destino.
+ Para usar um barramento de eventos da mesma forma Região da AWS que esta regra:
1. Selecione **Barramento de eventos na mesma conta e região**.
1. Em **Barramento de eventos para destino**, escolha a caixa suspensa e insira o nome do barramento de eventos. Também é possível selecionar o barramento de eventos na lista suspensa.
Para obter mais informações, consulte [Envio de eventos entre ônibus de eventos na mesma conta e região na Amazon EventBridge](eb-bus-to-bus.md).
+ Para usar um barramento de eventos em uma conta Região da AWS ou diferente, siga esta regra:
1. Selecione **Barramento de eventos em uma conta ou região diferente**.
1. Para **Barramento de eventos como destino**, insira o ARN do barramento de eventos que deseja usar.
Para obter mais informações, consulte:
+ [Enviar e receber eventos entre AWS contas na Amazon EventBridge](eb-cross-account.md)
+ [Envio e recebimento de eventos entre AWS regiões na Amazon EventBridge](eb-cross-region.md)
1. Para muitos tipos de destino, o EventBridge precisa de permissões para enviar eventos ao destino. Nesses casos, EventBridge pode criar a função do IAM necessária para que sua regra seja executada.
Em **Perfil de execução**, realize um dos seguintes procedimentos:
+ Para criar um novo perfil de execução para esta regra:
1. Selecione **Criar um novo perfil para este recurso específico**.
1. Insira um nome para essa função de execução ou use o nome gerado por EventBridge.
+ Para usar um perfil de execução existente para esta regra:
1. Selecione **Usar perfil existente**.
1. Insira ou selecione o nome do perfil de execução a ser usado na lista suspensa.
1. (Opcional) Para **Configurações adicionais**, especifique qualquer uma das configurações opcionais disponíveis para seu tipo de destino:
(Opcional) Para **fila de mensagens mortas, escolha se deseja usar uma fila** padrão do Amazon SQS como fila de mensagens mortas. EventBridge envia eventos que correspondam a essa regra para a fila de mensagens mortas se não forem entregues com sucesso ao destino. Faça um dos procedimentos a seguir:
+ Escolha **None** (Nenhum) para não usar uma fila de mensagens não entregues.
+ Escolha **Selecionar uma fila do Amazon SQS na conta atual da AWS para usar como a fila de mensagens não entregues** e depois selecione na lista suspensa a fila a ser usada.
+ Escolha **Selecionar uma fila do Amazon SQS em outra conta da AWS como uma fila de mensagens não entregues** e insira o ARN da fila a ser utilizada. Você deve anexar uma política baseada em recursos à fila que conceda EventBridge permissão para enviar mensagens para ela.
Para obter mais informações, consulte [Como conceder permissões para a fila de mensagens não entregues](eb-rule-dlq.md#eb-dlq-perms).
------
#### [ API destination ]
1. Selecione o **destino EventBridge da API**.
1. Escolha um destino de API novo ou existente:
+ Para usar um destino de API existente, selecione **Usar um destino de API existente**. Em seguida, selecione um destino de API na lista suspensa.
+ Para criar um novo destino de API, selecione **Criar um novo destino de API**. Em seguida, forneça os seguintes detalhes para o destino:
+ **Nome**: insira um nome para o destino.
Os nomes devem ser exclusivos em sua Conta da AWS. Nomes podem ter até 64 caracteres. Os caracteres válidos são **A-Z**, **a-z**, **0-9** e **.** **\_** **-** (hífen).
+ (Opcional) **Descrição**: insira uma descrição para o destino.
As descrições podem ter até 512 caracteres.
+ **Endpoint de destino da API**: o endpoint de URL para o destino.
O URL do endpoint deve começar com **https**. É possível incluir **\*** como um parâmetro de caminho curinga. É possível definir parâmetros de caminho a partir do atributo `HttpParameters` do destino.
+ **Método HTTP**: selecione o método HTTP usado ao invocar o endpoint.
+ (Opcional) **Limite de taxa de invocação por segundo**: insira o número máximo de invocações aceitas por segundo para este destino.
Este valor deve ser maior que zero. Por padrão, este valor é definido como 300.
+ **Conexão**: escolha usar uma conexão nova ou existente:
+ Para usar uma conexão existente, selecione **Usar uma conexão existente** e selecione a conexão na lista suspensa.
+ Para criar uma nova conexão para esse destino, selecione **Criar uma nova conexão** e defina o **nome**, o **tipo de destino** e o **tipo de autorização** da conexão. Também é possível adicionar uma **descrição** opcional para essa conexão.
1. Para muitos tipos de destino, o EventBridge precisa de permissões para enviar eventos ao destino. Nesses casos, EventBridge pode criar a função do IAM necessária para que sua regra seja executada.
Em **Perfil de execução**, realize um dos seguintes procedimentos:
+ Para criar um novo perfil de execução para esta regra:
1. Selecione **Criar um novo perfil para este recurso específico**.
1. Insira um nome para essa função de execução ou use o nome gerado por EventBridge.
+ Para usar um perfil de execução existente para esta regra:
1. Selecione **Usar perfil existente**.
1. Insira ou selecione o nome do perfil de execução a ser usado na lista suspensa.
1. (Opcional) Para **Configurações adicionais**, especifique qualquer uma das configurações opcionais disponíveis para seu tipo de destino:
Observe que EventBridge pode não exibir todos os campos a seguir para um determinado AWS serviço.
1. (Opcional) Em Configurar entrada de destino, escolha como deseja personalizar o texto enviado ao destino para eventos correspondentes. Escolha uma das seguintes opções:
+ **Eventos correspondentes** — EventBridge envia todo o evento de origem original para o destino. Esse é o padrão.
+ **Parte dos eventos correspondentes** — envia EventBridge apenas a parte especificada do evento de origem original para o destino.
Em **Especificar a parte do evento correspondente**, especifique um caminho JSON que defina a parte do evento que você deseja enviar EventBridge para o destino.
+ **Constante (texto JSON)** — EventBridge envia somente o texto JSON especificado para o destino. Nenhuma parte do evento de origem original é enviada.
Em **Especificar a constante em JSON**, especifique o texto JSON que você deseja enviar EventBridge para o destino em vez do evento.
+ **Transformador de entrada** — Configure um transformador de entrada para personalizar o texto que você deseja EventBridge enviar ao alvo. Para obter mais informações, consulte [Transformação EventBridge de insumos da Amazon](eb-transform-target-input.md).
1. Selecione **Configurar transformador de entrada**.
1. Configure o transformador de entrada seguindo as etapas em [Configurando um transformador de entrada ao criar uma regra no EventBridge](eb-transform-input-rule.md).
1. (Opcional) Em **Política de repetição**, EventBridge especifique como tentar enviar novamente um evento para um destino após a ocorrência de um erro.
+ **Idade máxima do evento** — insira o tempo máximo (em horas, minutos e segundos) EventBridge para reter eventos não processados. O padrão é 24 horas.
+ **Tentativas de repetição** — insira o número máximo de vezes que EventBridge você deve tentar enviar novamente um evento para o destino após a ocorrência de um erro. O padrão é 185 vezes.
1. (Opcional) Para **fila de mensagens mortas, escolha se deseja usar uma fila** padrão do Amazon SQS como fila de mensagens mortas. EventBridge envia eventos que correspondam a essa regra para a fila de mensagens mortas se não forem entregues com sucesso ao destino. Faça um dos procedimentos a seguir:
+ Escolha **None** (Nenhum) para não usar uma fila de mensagens não entregues.
+ Escolha **Selecionar uma fila do Amazon SQS na AWS conta atual para usar como fila de mensagens mortas e, em seguida, selecione a fila** a ser usada na lista suspensa.
+ Escolha **Selecionar uma fila do Amazon SQS em outra conta da AWS como uma fila de mensagens não entregues** e insira o ARN da fila a ser utilizada. Você deve anexar uma política baseada em recursos à fila que conceda EventBridge permissão para enviar mensagens para ela.
Para obter mais informações, consulte [Como conceder permissões para a fila de mensagens não entregues](eb-rule-dlq.md#eb-dlq-perms).
Para obter mais informações, consulte [Destinos de API como alvos na Amazon EventBridge](eb-api-destinations.md).
------
#### [ AWS service (Serviço da AWS) ]
1. Selecione **AWS service (Serviço da AWS)**.
1. Em **Selecionar um destino**, selecione um AWS service (Serviço da AWS) para usar como destino.
1. Se você escolher um AWS serviço que ofereça suporte a metas entre contas, poderá selecionar uma meta na mesma conta do barramento de eventos ou em uma conta diferente.
+ Para um destino na mesma conta, para **Tipo de destino**, selecione **Destino nesta conta**.
1. Forneça as informações solicitadas para o serviço selecionado.
**nota**
Os campos exibidos variam de acordo com o serviço selecionado. Para obter mais informações sobre os destinos disponíveis, consulte [Alvos de barramento de eventos disponíveis no EventBridge console](eb-targets.md#eb-console-targets).
1. Para muitos tipos de destino, o EventBridge precisa de permissões para enviar eventos ao destino. Nesses casos, EventBridge pode criar a função do IAM necessária para que sua regra seja executada.
Em **Perfil de execução**, realize um dos seguintes procedimentos:
+ Para criar um novo perfil de execução para esta regra:
1. Selecione **Criar um novo perfil para este recurso específico**.
1. Insira um nome para essa função de execução ou use o nome gerado por EventBridge.
+ Para usar um perfil de execução existente para esta regra:
1. Selecione **Usar perfil existente**.
1. Insira ou selecione o nome do perfil de execução a ser usado na lista suspensa.
+ Para um alvo em uma conta diferente, em **Tipo de destino**, selecione **Alvo em outra AWS conta**.
1. Insira o ARN do recurso de destino para o qual você deseja enviar eventos.
1. Forneça todas as informações adicionais solicitadas para o serviço selecionado.
1. Selecione o nome da função de execução a ser usada na lista suspensa.
1. (Opcional) Para **Configurações adicionais**, especifique qualquer uma das configurações opcionais disponíveis para seu tipo de destino:
1. (Opcional) Em Configurar entrada de destino, escolha como deseja personalizar o texto enviado ao destino para eventos correspondentes. Escolha uma das seguintes opções:
+ **Eventos correspondentes** — EventBridge envia todo o evento de origem original para o destino. Esse é o padrão.
+ **Parte dos eventos correspondentes** — envia EventBridge apenas a parte especificada do evento de origem original para o destino.
Em **Especificar a parte do evento correspondente**, especifique um caminho JSON que defina a parte do evento que você deseja enviar EventBridge para o destino.
+ **Constante (texto JSON)** — EventBridge envia somente o texto JSON especificado para o destino. Nenhuma parte do evento de origem original é enviada.
Em **Especificar a constante em JSON**, especifique o texto JSON que você deseja enviar EventBridge para o destino em vez do evento.
+ **Transformador de entrada** — Configure um transformador de entrada para personalizar o texto que você deseja EventBridge enviar ao alvo. Para obter mais informações, consulte [Transformação EventBridge de insumos da Amazon](eb-transform-target-input.md).
1. Selecione **Configurar transformador de entrada**.
1. Configure o transformador de entrada seguindo as etapas em [Configurando um transformador de entrada ao criar uma regra no EventBridge](eb-transform-input-rule.md).
1. (Opcional) Em **Política de repetição**, EventBridge especifique como tentar enviar novamente um evento para um destino após a ocorrência de um erro.
+ **Idade máxima do evento** — insira o tempo máximo (em horas, minutos e segundos) EventBridge para reter eventos não processados. O padrão é 24 horas.
+ **Tentativas de repetição** — insira o número máximo de vezes que EventBridge você deve tentar enviar novamente um evento para o destino após a ocorrência de um erro. O padrão é 185 vezes.
1. (Opcional) Para **fila de mensagens mortas, escolha se deseja usar uma fila** padrão do Amazon SQS como fila de mensagens mortas. EventBridge envia eventos que correspondam a essa regra para a fila de mensagens mortas se não forem entregues com sucesso ao destino. Faça um dos procedimentos a seguir:
+ Escolha **None** (Nenhum) para não usar uma fila de mensagens não entregues.
+ Escolha **Selecionar uma fila do Amazon SQS na AWS conta atual para usar como fila de mensagens mortas e, em seguida, selecione a fila** a ser usada na lista suspensa.
+ Escolha **Selecionar uma fila do Amazon SQS em outra conta da AWS como uma fila de mensagens não entregues** e insira o ARN da fila a ser utilizada. Você deve anexar uma política baseada em recursos à fila que conceda EventBridge permissão para enviar mensagens para ela.
Para obter mais informações, consulte [Como conceder permissões para a fila de mensagens não entregues](eb-rule-dlq.md#eb-dlq-perms).
------
1. (Opcional) Selecione **Adicionar outro destino** para adicionar outro destino a essa regra.
1. Escolha **Próximo**.
## Configurar tags e regra de revisão
Por fim, insira as tags desejadas para a regra, revise e crie a regra.
**Para configurar tags, revisar e criar a regra**
1. (Opcional) Insira uma ou mais tags para a regra. Para obter mais informações, consulte [Recursos de marcação na Amazon EventBridge](eb-tagging.md).
1. Escolha **Próximo**.
1. Analise os detalhes da nova regra. Para fazer mudanças a qualquer seção, escolha o botão **Editar** próximo à seção.
Quando estiver satisfeito com os detalhes da regra, escolha **Criar regra**.