changeNotification-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt die Benachrichtigung dar, die an den Abonnenten (App) eines Microsoft Graph-Abonnements gesendet wird. Alle Eigenschaften dieser Ressource sind schreibgeschützt.

Weitere Informationen finden Sie unter Verwenden von Microsoft Graph zum Abrufen von Änderungsbenachrichtigungen.

Methoden

Keine.

Eigenschaften

Hinweis:
Die changeType-Eigenschaft ist erforderlich und nur in Änderungsbenachrichtigungen vorhanden. Die lifecycleEvent-Eigenschaft ist erforderlich und nur in Lebenszyklusbenachrichtigungen vorhanden. Diese beiden Eigenschaften schließen sich gegenseitig aus; Eine Benachrichtigung enthält nur einen von ihnen.

Eigenschaft Typ Beschreibung
changeType changeType Gibt den Typ der Änderung an, durch die die Änderungsbenachrichtigung ausgelöst wird. Erforderlich und nur für Änderungsbenachrichtigungen vorhanden. Schließt sich gegenseitig mit lifecycleEvent aus. Unterstützte Werte sind: created, updated, deleted.
clientState string Wert der gesendeten clientState-Eigenschaft , die in der Abonnementanforderung angegeben ist (falls vorhanden). Die maximale Länge ist 255 Zeichen. Der Client kann überprüfen, ob die Änderungsbenachrichtigung vom Dienst stammt, indem er die Werte der clientState-Eigenschaft vergleicht. Der Wert der clientState-Eigenschaft , die mit dem Abonnement gesendet wird, wird mit dem Wert der clientState-Eigenschaft verglichen, die mit jeder Änderungsbenachrichtigung empfangen wird. Optional.
encryptedContent changeNotificationEncryptedContent (Vorschau) Verschlüsselter Inhalt, der an die Änderungsbenachrichtigung angehängt ist. Nur angegeben, wenn encryptionCertificate und includeResourceData während der Abonnementanforderung definiert wurden und die Ressource dies unterstützt. Optional.
id string Eindeutige ID für die Benachrichtigung. Optional.
lifecycleEvent lifecycleEventType Der Typ der Lebenszyklusbenachrichtigung. Erforderlich und nur für Lebenszyklusbenachrichtigungen vorhanden. Schließt sich gegenseitig mit changeType aus. Unterstützte Werte: missed, subscriptionRemoved, reauthorizationRequired.
resource string Der URI der Ressource, die die Änderungsbenachrichtigung relativ zu https://graph.microsoft.comausgegeben hat. Erforderlich.
resourceData resourceData Der Inhalt dieser Eigenschaft hängt vom Typ der Ressource ab, die abonniert wurde. Optional.
subscriptionExpirationDateTime DateTimeOffset Die Ablaufzeit für das Abonnement. Erforderlich.
subscriptionId GUID Der eindeutige Bezeichner des Abonnements, das die Benachrichtigung generiert hat. Erforderlich.
tenantId GUID Der eindeutige Bezeichner des Mandanten, von dem die Änderungsbenachrichtigung stammt. Erforderlich.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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