Un événement est un enregistrement de données reflétant des changements d'état. Lorsqu'une ressource est créée, qu'une configuration est mise à jour ou qu'un utilisateur effectue une action, le service responsable capture ce changement et le publie sur EventBridge.
Tous les événements sont conformes à la spécification CloudEvents 1.0, une norme ouverte maintenue par la Cloud Native Computing Foundation (CNCF). Cette norme garantit un format d'événement cohérent et portable pour toutes les sources d'événements.
Structure d'un événement
Chaque événement se compose de deux parties :
Attributs de contexte : Métadonnées qui identifient et décrivent l'événement (
source,type,idet d'autres attributs définis par la spécification CloudEvents).Charge utile de données : Le contenu de l'événement, qui varie selon la source de l'événement.
Les deux champs les plus importants sont source et type. Ensemble, ils indiquent l'origine de l'événement et la nature de l'action survenue :
{
"source": "acs:aliyuncvc",
"type": "aliyuncvc:MeetingEvent:MemberOperate",
...
}Dans cet extrait, source identifie le service à l'origine de l'événement, tandis que type précise l'événement spécifique (une opération effectuée par un membre lors d'une réunion).
L'exemple suivant illustre un événement complet publié sur EventBridge :
{
"specversion": "1.0",
"id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
"source": "acs:aliyuncvc",
"type": "aliyuncvc:MeetingEvent:MemberOperate",
"subject": "acs.aliyuncvc:cn-hangzhou:{AccountId}:215672",
"time": "2020-11-19T21:04:41+08:00",
"data": {
"meetingName": "swqd",
"groupId": "456",
"action": "camera_off",
"time": 1590592527490,
"userId": "199525",
"meetingUUID": "hz-20864c8f-b10d-45cd-9935-884bca1b****"
},
"aliyunaccountid": "123456789098****",
"aliyunpublishtime": "2020-11-19T21:04:42.179PRC",
"aliyuneventbusname": "default",
"aliyunregionid": "cn-hangzhou",
"aliyunpublishaddr": "172.25.XX.XX"
}Attributs standard CloudEvents
Ces attributs sont définis par la spécification CloudEvents 1.0. EventBridge s'appuie sur ces attributs pour le routage, l'interrogation et la déduplication des événements.
Attributs obligatoires
**id** (String)
Identifiant unique de l'événement. La combinaison source + id doit être unique pour chaque événement distinct. Si le même événement est renvoyé en raison d'une erreur réseau, il peut conserver le même id. Les consommateurs considèrent comme dupliqués les événements partageant les mêmes valeurs source et id. EventBridge utilise l'attribut id pour suivre les événements tout au long de leur routage vers les cibles.
Exemple : 45ef4dewdwe1-7c35-447a-bd93-fab****
**source** (String)
Service ayant produit l'événement. Cette valeur identifie le contexte dans lequel l'événement s'est produit, y compris le type de source d'événement et le mécanisme de publication. Les producteurs doivent veiller à ce que la combinaison source + id soit unique pour chaque événement.
Exemple : acs:aliyuncvc
**specversion** (String)
Version de la spécification CloudEvents à laquelle l'événement est conforme.
Exemple : 1.0
**type** (String)
Type d'événement, associé à la source de l'événement. EventBridge utilise cette valeur pour le routage, l'interrogation et l'application des politiques. Le producteur définit le format, qui peut inclure des informations de version.
Exemple : aliyuncvc:MeetingEvent:MemberOperate
Attributs facultatifs
**datacontenttype** (String)
Type de contenu de l'attribut data. EventBridge prend uniquement en charge le type application/json;charset=utf-8.
**dataschema** (URI)
URI pointant vers le schéma de l'attribut data.
**subject** (String)
Sujet de l'événement dans le contexte de la source d'événement. Contient des noms de ressources Alibaba Cloud (ARN) qui identifient les ressources impliquées dans l'événement. Utilisez cet attribut pour filtrer les abonnements lorsque la seule information source n'est pas suffisamment spécifique.
Exemple : acs.aliyuncvc:cn-hangzhou:{AccountId}:215672
**time** (Timestamp)
Horodatage indiquant quand l'événement s'est produit. Si l'heure exacte est inconnue, le producteur peut définir cette valeur sur l'heure actuelle. Toutefois, tous les producteurs d'une même source doivent définir le paramètre source avec la même valeur.
Exemple : 2020-11-19T21:04:41+08:00
**data** (Struct)
Charge utile de l'événement. La source de l'événement détermine la structure, qui contient les détails de l'action survenue.
Attributs d'extension Alibaba Cloud
EventBridge ajoute les attributs suivants à chaque événement après sa réception. Ces attributs ne font pas partie de la spécification CloudEvents.
| Attribut | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
aliyunaccountid |
String | Non | ID du compte Alibaba Cloud du producteur de l'événement. | 123456789098**** |
aliyunpublishtime |
Timestamp | Non | Horodatage de la réception de l'événement par EventBridge. | 2020-11-19T21:04:42.179PRC |
aliyuneventbusname |
String | Oui | Nom du bus d'événements ayant reçu l'événement. | default |
aliyunregionid |
String | Non | Région dans laquelle EventBridge a reçu l'événement. | cn-hangzhou |
aliyunpublishaddr |
String | Non | Adresse IP du serveur EventBridge ayant reçu l'événement. | 172.25.XX.XX |
Types d'événements
EventBridge prend en charge deux catégories d'événements :
Événements des services Alibaba Cloud
Les services Alibaba Cloud s'intègrent automatiquement à EventBridge en tant que sources d'événements. Pour consulter la liste des services pris en charge, reportez-vous à la rubrique Sources d'événements des services Alibaba Cloud Alibaba Cloud service event sources.
Événements d'applications personnalisées
Pour publier des événements depuis vos propres applications, connectez votre application à EventBridge via un SDK.