Documentation sur Oracle Cloud Infrastructure

Contenu d'un message d'événement

Découvrir le contenu d'un message d'événement.

Chaque message d'événement comprend deux parties principales : 

  • Enveloppe : Conteneur pour tous les messages d'événement

  • Données utiles : Données de la ressource émettant le message d'événement

Enveloppe d'événement

Ces attributs d'enveloppe d'événement sont les mêmes pour tous les événements. La structure de l'enveloppe suit le format standard de l'industrie CloudEvents hébergé par la Cloud Native Computing Foundation (CNCF).

Propriété Description
cloudEventsVersion

Version de la spécification CloudEvents.

Note :Le service d'événements utilisent la version 0.1 de l'enveloppe d'événement CloudEvents.

contentType Réglez la valeur à application/json. Type de contenu des données incluses dans l'attribut data.
data Données utiles de l'événement. Toutes les informations contenues dans data sont tirées de la ressource émettant l'événement. Consultez le tableau suivant pour plus de détails sur la structure des données utiles.
eventID

UUID de l'événement. Cet identificateur n'est pas un OCID, mais seulement un ID unique pour l'événement.

eventTime Heure de l'événement dans le format d'horodatage RFC 3339.
eventType

Type de l'événement qui s'est produit. Pour la liste des services qui produisent des événements et la liste des types d'événement suivis par ces services, voir Services qui génèrent des événements.

Note : Le service qui produit l'événement peut également ajouter, supprimer ou modifier la signification d'un champ en publiant une nouvelle version d'un fichier eventType et en révisant le champ eventTypeVersion.

eventTypeVersion

Version du type d'événement.

extensions Identificateur Oracle Cloud du compartiment d'où provient l'événement. Si l'événement provient du compartiment racine de la location, cet attribut indique l'identificateur Oracle Cloud de la location. Cet attribut est obligatoire dans la mise en oeuvre Oracle Cloud Infrastructure de la spécification CloudEvents.
source Ressource qui a produit l'événement. Par exemple, une base de données autonome ou un seau du service de stockage d'objets.

Données utiles

Les données de ces champs dépendent du service qui a produit l'événement et du type d'événement qu'il définit.

Propriété Description
compartmentId

Identificateur Oracle Cloud du compartiment de la ressource émettant l'événement.

compartmentName Nom du compartiment de la ressource émettant l'événement.
resourceName Nom de la ressource émettant l'événement.
resourceId

Identificateur Oracle Cloud ou ID de la ressource émettant l'événement.
availabilityDomain Domaine de disponibilité de la ressource émettant l'événement.
freeFormTags

Marqueurs à structure libre ajoutés à la ressource émettant l'événement.

definedTags Marqueurs définis ajoutés à la ressource émettant l'événement.
additionalDetails

Conteneur pour les attributs uniques de la ressource émettant l'événement. Dans l'exemple d'événement de seau qui suit, les données utiles incluent trois attributs de stockage d'objets : 

  • namespace
  • publicAccessType
  • eTag

Pour déterminer les attributs inclus dans d'autres ressources, faites l'extraction d'un événement ou consultez les exemples de référence dans Services qui génèrent des événements.

Identificateurs de ressource

La plupart des types de ressource Oracle Cloud Infrastructure ont un identificateur unique affecté par Oracle, appelé identificateur Oracle Cloud (OCID). Pour des informations sur le format des OCID et sur les autres moyens d'identifier vos ressources, voir Identificateurs de ressource.

Exemple d'événement

Voici un exemple d'événement de seau émis par le service de stockage d'objets. 

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