changeNotification リソース タイプ

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

Microsoft Graph サブスクリプションのサブスクライバー (アプリ) に送信される通知を表します。 このリソースのすべてのプロパティは読み取り専用です。

詳細については、「 Microsoft Graph を使用して変更通知を取得する」を参照してください。

メソッド

なし。

プロパティ

プロパティ	型	説明
changeType	changeType	変更通知を発生させる変更の種類を示します。 サポートされている値は created、updated、deleted です。 必須です。
clientState	string	サブスクリプション要求で指定された clientState プロパティの値 (存在する場合)。 最大の長さは、255 文字です。 クライアントは、clientState プロパティの値を比較することで、変更通知がサービスから送信されたかどうかをチェックできます。 サブスクリプションで送信された clientState プロパティの値は、各変更通知で受信した clientState プロパティの値と比較されます。 省略可能。
encryptedContent	changeNotificationEncryptedContent	(プレビュー)変更通知と共に添付された暗号化されたコンテンツ。 サブスクリプション要求中に encryptionCertificate と includeResourceData が定義され、リソースでサポートされている場合にのみ指定されます。 省略可能。
id	string	通知の一意の ID。 省略可能。
lifecycleEvent	lifecycleEventType	現在の通知がライフサイクル通知の場合のライフサイクル通知の種類。 省略可能。 サポートされている値は、 missed、 subscriptionRemoved、 reauthorizationRequiredです。 省略可能。
resource	string	https://graph.microsoft.comを基準とした変更通知を生成したリソースの URI。 必須です。
resourceData	resourceData	このプロパティの内容は、サブスクリプションの対象となるリソースの種類に応じて異なります。 省略可能。
subscriptionExpirationDateTime	DateTimeOffset	サブスクリプションの有効期限が切れるとき。 必須です。
subscriptionId	Guid	通知を生成したサブスクリプションの一意識別子。 必須です。
tenantId	Guid	変更通知の送信元のテナントの一意識別子。 必須です。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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