Referência de estrutura de eventos

Os campos a seguir aparecem em todos os eventos entregues em um barramento de eventos e incluem os metadados do evento:

{
  "versão": "0",
  "id": "UUID",
  "detail-type": "event name",
  "origem": "event source",
  "conta": "ARN",
  "horário": "timestamp",
  "região": "region",
  "recursos": [
    "ARN"
  ],
  "detalhe": {
    JSON object
  }
}

versão

Por padrão, isso é definido como 0 (zero) em todos os eventos.

id

Um UUID versão 4 gerado para cada evento. É possível usar um id para rastrear eventos à medida que eles percorrem as regras até os destinos.

detail-type

Identifica, em combinação com o campo source, os campos e os valores que serão exibidos no campo detail.

Eventos que são entregues por CloudTrail têm AWS API Call via CloudTrail como valordetail-type.

origem

Identifica o serviço que gerou o evento. Todos os eventos provenientes dos serviços da AWS começam com "aws". Os eventos gerados pelo cliente podem ter qualquer valor aqui, desde que ele não comece com "aws". Recomendamos o uso de strings de nome de domínio inversas no estilo pacote-nome Java.

Para encontrar o valor correto source para um AWS serviço, consulte a tabela de chaves de condição, selecione um serviço na lista e procure o prefixo do serviço. Por exemplo, o source valor para a Amazon CloudFront éaws.cloudfront.

conta

O número de 12 dígitos que identifica uma AWS conta.

horário

O time stamp do evento, que pode ser especificado pelo serviço que originou o evento. Se o evento abranger um intervalo de tempo, o serviço poderá informar o horário de início, portanto, esse valor poderá ser anterior à hora em que o evento é recebido.

região

Identifica a AWS região onde o evento se originou.

recursos

Esta matriz JSON contém ARNs que identificam os recursos que estão envolvidos no evento. O serviço que gera o evento determina se esses ARNs devem ser incluídos. Por exemplo, as alterações de estado da instância do Amazon EC2 incluem os ARNs da instância do Amazon EC2, e os eventos do Auto Scaling incluem os ARNs de instâncias e grupos do Auto Scaling, mas as chamadas de API com o AWS CloudTrail não incluem os ARNs de recursos.

detalhe

Um objeto JSON contém informações sobre o evento. O serviço que gera o evento determina o conteúdo desse campo. Pode ser "{}".

AWS Os eventos de chamada de API têm objetos detalhados com aproximadamente 50 campos aninhados em vários níveis de profundidade.

nota

PutEventsaceita dados no formato JSON. Para o tipo de dados do número JSON (número inteiro), as restrições são: um valor mínimo de -9.223.036.036.854.775.807.

exemplo Exemplo: notificação de alteração do estado da instância do Amazon EC2

O evento a seguir na Amazon EventBridge indica que uma instância do Amazon EC2 está sendo encerrada.

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

Informações mínimas necessárias para um evento personalizado válido

Ao criar eventos personalizados, eles devem incluir os seguintes campos:

• detail

• detail-type

• source

{
  "detail-type": "event name",
  "source": "event source",
  "detail": {
  }
}