changeNotification-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt die Benachrichtigung dar, die an den Abonnenten gesendet wird. Alle Eigenschaften dieser Ressource sind schreibgeschützt.

Einzelheiten finden Sie unter Verwenden der Microsoft Graph-API, um Änderungsbenachrichtigungen zu erhalten.

Methoden

Keine.

Eigenschaften

Eigenschaft	Typ	Beschreibung
changeType	changeType	Gibt den Typ der Änderung an, die die Änderungsbenachrichtigung auslöst. Unterstützte Werte sind: created, updated, deleted. Erforderlich.
clientState	string	Wert der clientState-Eigenschaft , die in der Abonnementanforderung angegeben wurde (sofern vorhanden). Die maximale Länge ist 255 Zeichen. Der Client kann überprüfen, ob die Änderungsbenachrichtigung vom Dienst stammt, indem er die Werte der eigenschaft "clientState" vergleicht. Der Wert der clientState-Eigenschaft , die mit dem Abonnement gesendet wird, wird mit dem Wert der clientState-Eigenschaft verglichen, die bei jeder Änderungsbenachrichtigung empfangen wurde. Optional.
encryptedContent	changeNotificationEncryptedContent	(Vorschau) Verschlüsselte Inhalte, die mit der Änderungsbenachrichtigung verbunden sind. Wird nur bereitgestellt, wenn encryptionCertificate und includeResourceData während der Abonnementanforderung definiert wurden und wenn die Ressource dies unterstützt. Optional.
id	string	Eindeutige ID für die Benachrichtigung. Optional.
lifecycleEvent	lifecycleEventType	Der Typ der Lebenszyklusbenachrichtigung, wenn es sich bei der aktuellen Benachrichtigung um eine Lebenszyklusbenachrichtigung handelt. Optional. Unterstützte Werte sind missed, subscriptionRemoved, reauthorizationRequired. Optional.
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

Es folgt eine JSON-Darstellung der Ressource.

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