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á.
Padrões de eventos do Amazon EventBridge
É provável que você não queira processar todos os eventos que são entregues a um determinado barramento de eventos ou pipe. Em vez disso, você talvez deseje selecionar um subconjunto de todos os eventos entregues, com base na origem, no tipo e/ou nos atributos desses eventos.
Para especificar quais eventos enviar a um destino, crie um padrão de eventos. Um padrão de eventos define os dados usados pelo EventBridge para determinar se o evento deve ser enviado ao destino. Se o padrão corresponder ao evento, o EventBridge enviará o evento ao destino. Os padrões de eventos têm a mesma estrutura que os eventos aos quais correspondem. Um padrão de evento corresponde a um evento ou não corresponde.
Por exemplo, considere os seguintes eventos do Amazon EC2:
{
"version": "0",
"id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
"detail-type": "EC2 Instance State-change Notification",
"source": "aws.ec2",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "us-west-1",
"resources": [
"arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0"
],
"detail": {
"instance-id": "i-1234567890abcdef0",
"state": "terminated"
}
}
O padrão de eventos a seguir seleciona todos os eventos instance-termination
do Amazon EC2. Ele faz isso especificando três requisitos para ter correspondência com um evento:
A origem do evento deve ser o Amazon EC2.
O evento deve ser uma notificação de alteração de estado do Amazon EC2.
O estado da instância do Amazon EC2 deve ser
terminated
.
{
"source": ["aws.ec2"],
"detail-type": ["EC2 Instance State-change Notification"],
"detail": {
"state": ["terminated"]
}
}
Observe que, neste exemplo, o padrão de eventos inclui campos sobre o evento, source
e detail-type
, bem como um campo do corpo do evento, state
.
Importante
No EventBridge, é possível criar regras que possam resultar em cobranças e controle de utilização mais altos do que o esperado. Por exemplo, é possível criar, por engano, uma regra que leva a um loop infinito, em que uma regra é acionada recursivamente sem fim. Supõe-se que uma regra possa detectar que as ACLs foram alteradas em um bucket do Amazon S3 e acionar o software para alterá-las para o estado desejado. Se a regra não for gravada cuidadosamente, a alteração subsequente às ACLs disparará a regra novamente, criando um loop infinito.
Para obter orientação sobre como escrever regras precisas e padrões de eventos para minimizar esses resultados inesperados, consulte Práticas recomendadas para regras e Práticas recomendadas.
Padrões de evento para barramentos de eventos
Para barramentos de eventos, você pode especificar um padrão de eventos para cada regra criada para o barramento. Dessa forma, você pode selecionar quais eventos enviar a destinos específicos. Os padrões de eventos para barramentos de eventos podem ser comparados com a origem, os metadados e/ou os valores de detalhes do evento.
O seguinte vídeo aborda os conceitos básicos dos padrões de eventos para barramentos de eventos:
Padrões de eventos para o EventBridge Pipes
Para o EventBridge Pipes, você pode especificar padrões de eventos para filtrar os eventos de origem do pipe que você deseja entregar ao destino do pipe. Como cada pipe tem uma única origem de eventos, os padrões de eventos para pipes podem ser comparados com metadados e/ou valores de detalhes do evento.
Nem todos os campos de eventos podem ser usados para construir padrões de eventos do pipe. Para ter mais informações, consulte Filtrar.