Esta página ha sido traducida por una máquina.

Contenido de un mensaje de evento

Obtener información sobre el contenido de un mensaje de evento.

Cada mensaje de evento incluye dos partes principales:

  • Sobre: contenedor para todos los mensajes de evento

  • Carga útil: datos del recurso que emite el mensaje de evento

Sobre de evento

Estos atributos de un sobre de evento son los mismos para todos los eventos. La estructura del sobre sigue el formato estándar del sector CloudEvents de Cloud Native Computing Foundation ( CNCF).

Propiedad Descripción
cloudEventsVersion

Versión de la especificación CloudEvents.

Nota: Events emplea la especificación de versión 0.1 del sobre de evento CloudEvents.

contentType Establecido en application/json. Tipo de contenido de los datos incluidos en el atributo data.
data Carga útil del evento. Toda la información de data procede del recurso que emite el evento. Consulte la siguiente tabla para obtener más información sobre la estructura de la carga útil.
eventID

El UUID del evento. Este identificador no es un OCID, sino solo un ID único para el evento.

eventTime Hora a la que se ha producido el evento, expresada en el formato de marca de tiempo RFC 3339.
eventType

Tipo de evento que se ha producido. Para ver una lista de todos los servicios que producen eventos y los tipos de eventos que controlan dichos servicios, consulte Servicios que generan eventos.

Nota: El servicio que genera el evento también puede agregar, suprimir o cambiar el significado de un campo si se publica una nueva versión de eventType y se revisa el campo eventTypeVersion.

eventTypeVersion

Versión del tipo de evento.

extensions OCID del compartimento desde el que se origina el evento. Si el evento se origina en el compartimento raíz del arrendamiento, este atributo especifica un OCID de arrendamiento. Este atributo es obligatorio en la implantación de Oracle Cloud Infrastructure de la especificación de CloudEvents.
source Recurso que produjo el evento. Por ejemplo, un cubo de Autonomous Database o de Object Storage.

Carga útil

Los datos de estos campos dependen del servicio que ha generado el evento y del tipo de evento definido.

Propiedad Descripción
compartmentId

OCID del compartimento del recurso que emite el evento.

compartmentName Nombre del compartimento del recurso que emite el evento.
resourceName Nombre del recurso que emite el evento.
resourceId

OCID o ID del recurso que emite el evento.

availabilityDomain Dominio de disponibilidad del recurso que emite el evento.
freeFormTags

Etiquetas de formato libre agregadas al recurso que emite el evento.

definedTags Etiquetas definidas agregadas al recurso que emite el evento.
additionalDetails

Contenedor para atributos únicos para el recurso que emite el evento. En el siguiente evento de cubo de ejemplo, la carga útil incluye tres atributos de Object Storage: 

  • namespace
  • publicAccessType
  • eTag

Para determinar qué atributos se incluyen para otros recursos, recupere un evento o consulte los ejemplos de referencia que se muestran en Servicios que generan eventos.

Identificadores de recursos

La mayoría de los tipos de recursos de Oracle Cloud Infrastructure tienen un identificador único asignado por Oracle denominado Oracle Cloud ID (OCID). Para obtener información sobre el formato de OCID y otras formas de identificar los recursos, consulte Identificadores de recursos.

Ejemplo de evento

A continuación, se muestra un ejemplo de un evento de cubo generado por 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"
		}
	}
}