Documentazione di Oracle Cloud Infrastructure

Contenuto di un messaggio evento

Informazioni sul contenuto di un messaggio evento.

Ogni messaggio di evento include due parti principali: 

  • Busta: un contenitore per tutti i messaggi di evento

  • Payload: i dati della risorsa che emette il messaggio dell'evento

Busta evento

Questi attributi per una busta evento sono uguali per tutti gli eventi. La struttura della busta segue il formato standard del settore CloudEvents ospitato da Cloud Native Computing Foundation ( CNCF).

Proprietà descrizione;
cloudEventsVersion

La versione della specifica CloudEvents.

Nota: gli eventi utilizzano la specifica della versione 0.1 dell'envelope di evento CloudEvents.

contentType Impostare su application/json. Il tipo di contenuto dei dati contenuti nell'attributo data.
data Il payload dell'evento. Tutte le informazioni contenute in data provengono dalla risorsa che emette l'evento. Per ulteriori dettagli sulla struttura del payload, vedere la tabella riportata di seguito.
eventID

L'UUID dell'evento. Questo identificativo non è un OCID, ma solo un ID univoco per l'evento.

eventTime L'ora dell'evento, espressa nel formato dell'indicatore orario RFC 3339.
eventType

Tipo dell'evento verificatosi. Per un elenco di tutti i servizi che producono eventi e dei tipi pari di cui tali servizi tengono traccia, vedere Servizi che producono eventi.

Nota: il servizio che produce l'evento può anche aggiungere, rimuovere o modificare il significato di un campo pubblicando una nuova versione di un eventType e rivedendo il campo eventTypeVersion.

eventTypeVersion

Versione del tipo di evento.

extensions OCID del compartimento da cui ha origine l'evento. Se l'evento ha origine dal compartimento radice della tenancy, questo attributo specifica un OCID tenancy. Questo attributo è obbligatorio nell'implementazione di Oracle Cloud Infrastructure della specifica CloudEvents.
source La risorsa che ha prodotto l'evento. Ad esempio, un Autonomous Database o un bucket di storage degli oggetti.

Payload

I dati in questi campi dipendono dal servizio che ha prodotto l'evento e dal tipo di evento che definisce.

Proprietà Descrizione
compartmentId

OCID del compartimento della risorsa che emette l'evento.

compartmentName Nome del compartimento della risorsa che emette l'evento.
resourceName Nome della risorsa che emette l'evento.
resourceId

OCID o ID della risorsa che emette l'evento.
availabilityDomain Il dominio di disponibilità della risorsa che emette l'evento.
freeFormTags

Tag in formato libero aggiunte alla risorsa che emette l'evento.

definedTags Tag definite aggiunte alla risorsa che emette l'evento.
additionalDetails

Contenitore per gli attributi univoci della risorsa che emette l'evento. Nell'evento bucket di esempio riportato di seguito, il payload include tre attributi di storage degli oggetti: 

  • namespace
  • publicAccessType
  • eTag

Per determinare gli attributi inclusi per altre risorse, recuperare un evento o consultare i campioni di riferimento elencati in Servizi che producono eventi.

Identificativi risorsa

La maggior parte dei tipi di risorse Oracle Cloud Infrastructure ha un identificativo univoco assegnato da Oracle chiamato OCID (Oracle Cloud ID). Per informazioni sul formato OCID e su altri modi per identificare le risorse, vedere Identificativi risorsa.

Un evento di esempio

Di seguito è riportato un evento bucket di esempio emesso dallo storage degli oggetti. 

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