L'API Alert Center peut envoyer des notifications lorsque des alertes sont mises à jour. Pour recevoir des notifications, vous devez configurer vos paramètres de notification.
Notifications Pub/Sub
L'API Alert Center peut publier des notifications dans un sujet Pub/Sub. Après avoir créé un sujet et accordé
alerts-api-push-notifications@system.gserviceaccount.com l'autorisation de publication,
utilisez l'API de paramètres de mise à jour
de l'API Alert Center
pour définir ce sujet comme destination de notification. Une fois configurée, l'API Alert Center publie un message dans ce sujet pour chaque mise à jour, par exemple lorsqu'une nouvelle alerte arrive.
Attributs des messages Pub/Sub
Les sections suivantes décrivent les attributs inclus dans les messages Pub/Sub.
Attributs courants
alertcenter_resource_type: type de la ressource. La valeur acceptée est"ALERT".alertcenter_resource_status: état de la ressource. Les valeurs acceptées sont"CREATED","DELETED","UNDELETED"et"MODIFIED".alertcenter_payload_format: format de la charge utile. La valeur acceptée est"JSON".
Attributs d'alerte
alertcenter_start_time: heure à laquelle l'événement qui a déclenché cette alerte a commencé ou a été détecté.alertcenter_end_time: heure à laquelle l'événement qui a déclenché cette alerte a cessé d'être actif.alertcenter_type: type de l'alerte. Pour obtenir la liste des types d'alertes disponibles, consultez Types d'alertes Google Workspace.alertcenter_source: identifiant unique du système qui a signalé l'alerte.alertcenter_create_time: heure de création de cette alerte.alertcenter_update_time: dernière mise à jour de cette alerte.
Charge utile du message
La charge utile du message dépend de alertcenter_resource_type. Lorsque le
type de ressource est "ALERT", la charge utile correspond à l'un des types d'alertes
de l'API Alert Center. Le format de la charge utile dépend de alertcenter_payload_format. Lorsque le format est "JSON", la
charge utile est un objet JSON encodé en base64
.