Type de ressource changeNotification

Espace de noms: microsoft.graph

Représente la notification envoyée à l’abonné (application) d’un abonnement Microsoft Graph. Toutes les propriétés de cette ressource sont en lecture seule.

Pour plus d’informations, consultez Utiliser Microsoft Graph pour obtenir des notifications de modification.

Méthodes

Aucun.

Propriétés

Remarque :
La propriété changeType est requise et n’est présente que dans les notifications de modification. La propriété lifecycleEvent est requise et n’est présente que dans les notifications de cycle de vie. Ces deux propriétés s’excluent mutuellement ; Une notification n’inclut qu’un seul d’entre eux.

Propriété Type Description
changeType changeType Indique le type de modification qui déclenchera la notification de modification. Obligatoire et présent uniquement pour les notifications de modification. En exclusivité mutuelle avec lifecycleEvent. Les valeurs possibles sont : created, updated, deleted, unknownFutureValue. unknownFutureValue est une sentinelle d’énumération évolutive réservée à une extensibilité future. Son ajout n’introduit pas de nouveau type de notification ni ne modifie la remise de notification existante.
clientState string Valeur de la propriété clientState envoyée dans la demande d’abonnement (le cas échéant). La longueur maximale est de 255 caractères. Le client peut vérifier si la notification de modification provient du service en case activée si la notification de modification provient du service en comparant les valeurs de la propriété clientState. La valeur de la propriété clientState envoyée avec l’abonnement est comparée à la valeur de la propriété clientState reçue avec chaque notification de modification. Facultatif.
encryptedContent changeNotificationEncryptedContent (préversion) Contenu chiffré joint à la notification de modification. Fourni uniquement si encryptionCertificate et includeResourceData ont été définis lors de la demande d’abonnement et si la ressource le prend en charge. Facultatif.
id string ID unique pour la notification. Facultatif.
lifecycleEvent lifecycleEventType Type de notification de cycle de vie. Obligatoire et uniquement présent pour les notifications de cycle de vie. Mutuellement exclusif avec changeType. Valeurs prises en charge : missed, , subscriptionRemovedreauthorizationRequired.
ressource Chaîne L’URI de la ressource qui a émis la notification de modification relative à https://graph.microsoft.com. Obligatoire.
resourceData resourceData Le contenu de cette propriété dépend du type de ressource concerné par l’abonnement. Facultatif.
subscriptionExpirationDateTime DateTimeOffset Délai d’expiration de l’abonnement. Obligatoire.
subscriptionId Guid Identificateur unique de l’abonnement qui a généré la notification. Obligatoire.
tenantId Guid Identificateur unique du client d’où provient la notification de modification. Obligatoire.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.changeNotification",
  "changeType": "String",
  "clientState": "String",
  "encryptedContent": {
    "@odata.type": "microsoft.graph.changeNotificationEncryptedContent"
  },
  "id": "String (identifier)",
  "lifecycleEvent": "String",
  "resource": "String",
  "resourceData": {
    "@odata.type": "microsoft.graph.resourceData"
  },
  "subscriptionExpirationDateTime": "String (timestamp)",
  "subscriptionId": "Guid",
  "tenantId": "Guid"
}