AWS metadados de eventos de serviço - Amazon EventBridge
Evento personalizado mínimo válido

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á.

AWS metadados de eventos de serviço

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

Uma versão 4 UUID que é gerada 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

Uma JSON matriz que contém os recursos ARNs que identificam que estão envolvidos no evento. O serviço que gera o evento determina se eles devem ser incluídosARNs. Por exemplo, as mudanças no estado da EC2 instância da Amazon incluem a EC2 instância da AmazonARNs, os eventos do Auto Scaling ARNs incluem tanto para instâncias quanto para grupos de Auto Scaling, API mas as chamadas AWS CloudTrail com não incluem recursos. ARNs

detalhe

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

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

nota

PutEventsaceita dados em JSON formato. Para o tipo de dados JSON numérico (inteiro), as restrições são: um valor mínimo de -9.223.372.036.854.775.808 e um valor máximo de 9.223.372.036.854.775.807.

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

O evento a seguir na Amazon EventBridge indica que uma EC2 instância da Amazon 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": {
  }
}