Documentação do Oracle Cloud Infrastructure

Conteúdo de uma Mensagem de Evento

Saiba mais sobre o conteúdo de uma mensagem de evento.

Cada mensagem de evento inclui duas partes principais: 

  • Envelope: um contêiner para todas as mensagens de evento

  • Payload: os dados do recurso que está emitindo a mensagem de evento

Envelope de Evento

Esses atributos de um envelope de evento são os mesmos para todos os eventos. A estrutura do envelope segue o formato padrão do setor CloudEvents hospedado pela Cloud Native Computing Foundation (CNCF).

Propriedade Descrição
cloudEventsVersion

A versão da especificação do CloudEvents.

Observação:O serviço Events usa a especificação da versão 0.1 do envelope de evento CloudEvents.

contentType Defina como application/json. O tipo de conteúdo dos dados contidos no atributo data.
data O payload do evento. Todas as informações contidas em data são provenientes do recurso que emite o evento. Consulte a tabela a seguir para obter mais detalhes sobre a estrutura do payload.
eventID

O UUID do evento. Este identificador não é um OCID, mas apenas um ID exclusivo para o evento.

eventTime A hora do evento, expressa no formato de timestamp RFC 3339.
eventType

O tipo de evento que ocorreu. Para obter uma lista de todos os serviços que produzem eventos e os tipos de eventos que esses serviços rastreiam, consulte Serviços que Produzem Eventos.

Observação: O serviço que produz o evento também pode adicionar, remover ou alterar o significado de um campo publicando uma nova versão de um eventType e revisando o campo eventTypeVersion.

eventTypeVersion

A versão do tipo de evento.

extensions O OCID do compartimento do qual o evento se origina. Se o evento se originar do compartimento raiz da tenancy, este atributo especificará um OCID da tenancy. Este atributo é obrigatório na implementação do Oracle Cloud Infrastructure da especificação CloudEvents.
source O recurso que produziu o evento. Por exemplo, um Autonomous Database ou um bucket do serviço Object Storage.

Payload

Os dados desses campos dependem do serviço que produziu o evento e do tipo de evento que ele define.

Propriedade Descrição
compartmentId

O OCID do compartimento do recurso que emite o evento.

compartmentName O nome do compartimento do recurso que emite o evento.
resourceName O nome do recurso que emite o evento.
resourceId

Um OCID ou um ID para o recurso que emite o evento.
availabilityDomain O domínio de disponibilidade do recurso que emite o evento.
freeFormTags

Tags de formato livre adicionadas ao recurso que emite o evento.

definedTags Tags definidas adicionadas ao recurso que emite o evento.
additionalDetails

Um contêiner para atributos exclusivos do recurso que emite o evento. No exemplo de evento de bucket que se segue, o payload inclui três atributos do serviço Object Storage: 

  • namespace
  • publicAccessType
  • eTag

Para determinar quais atributos estão incluídos para outros recursos, recupere um evento ou consulte as amostras de referência listadas em Serviços que Produzem Eventos.

Identificadores de Recursos

A maioria dos tipos de recursos do Oracle Cloud Infrastructure tem um identificador exclusivo designado pela Oracle chamado OCID (Oracle Cloud ID). Para obter informações sobre o formato do OCID e outras maneiras de identificar seus recursos, consulte Identificadores de Recursos.

Um Exemplo de Evento

Veja a seguir um exemplo de evento de bucket emitido pelo serviço Object Storage. 

{
	"cloudEventsVersion": "0.1",
	"eventID": "<unique_ID>",
	"eventType": "com.oraclecloud.objectstorage.deletebucket",
	"source": "objectstorage",
	"eventTypeVersion": "1.0",
	"eventTime": "2019-01-10T21:19:24Z",
	"contentType": "application/json",
	"extensions": {
		"compartmentId": "ocid1.compartment.oc1..<unique_ID>"
	},
	"data": {
		"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
		"compartmentName": "example_name",
		"resourceName": "my_bucket",
		"resourceId": "ocid1.compartment.oc1..<unique_ID>",
		"availabilityDomain": "NfHZ:PHX-AD-2",
		"freeFormTags": {
			"Department": "Finance"
		},
		"definedTags": {
			"Operations": {
				"CostCenter": "42"
			}
		},
		"additionalDetails": {
			"namespace": "example_namespace",
			"publicAccessType": "NoPublicAccess",
			"eTag": "f8ffb6e9-f602-460f-a6c0-00b5abfa24c7"
		}
	}
}