Padrões de EventBridge eventos da Amazon

É 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 evento define os dados EventBridge usados para determinar se o evento deve ser enviado ao destino. Se o padrão do evento corresponder ao evento, EventBridge envia o evento para o 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 o seguinte evento da 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 EC2 instance-termination eventos da Amazon. Ele faz isso especificando três requisitos para ter correspondência com um evento:

1. A origem do evento deve ser a Amazon EC2.

2. O evento deve ser uma notificação de EC2 mudança de estado da Amazon.

3. O estado da EC2 instância da Amazon deve serterminated.

{
  "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

Em EventBridge, é possível criar regras que podem gerar higher-than-expected cobranças e estrangulamentos. Por exemplo, é possível criar, por engano, uma regra que leva a um loop infinito, em que uma regra é acionada recursivamente sem fim. Suponha que você ACLs tenha criado uma regra para detectar as alterações em um bucket do Amazon S3 e acionar o software para alterá-las para o estado desejado. Se a regra não for escrita com cuidado, a alteração subsequente na ACLs acionará 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 EventBridge Pipes

Para EventBridge Pipes, você pode especificar padrões de eventos para filtrar os eventos da fonte de tubulação que você deseja entregar ao destino da tubulação. 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 obter mais informações, consulte Filtrar.