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 (die 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
Eigenschaft | Typ | Beschreibung |
---|---|---|
changeType | changeType | Gibt den Typ der Änderung an, die die Änderungsbenachrichtigung auslösen wird. 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 clientState-Eigenschaft 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 wird. Optional. |
encryptedContent | changeNotificationEncryptedContent | (Vorschau) Verschlüsselter Inhalt, der mit der Änderungsbenachrichtigung verknüpft ist. Wird nur bereitgestellt, 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, wenn die aktuelle Benachrichtigung eine Lebenszyklusbenachrichtigung ist. Optional. Unterstützte Werte sind missed , subscriptionRemoved , reauthorizationRequired . Optional. |
resource | string | Der URI der Ressource, die die Änderungsbenachrichtigung relativ zu https://graph.microsoft.com ausgegeben 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"
}
}