changeNotification リソース タイプ
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
サブスクライバーに送信される通知を表します。 このリソースのすべてのプロパティは読み取り専用です。
詳細については、「Microsoft Graph API を使用して変更通知を取得する」を参照してください。
メソッド
なし。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 | を基準に変更通知を発行したリソースの URI https://graph.microsoft.comです。 必須です。 |
| 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"
}
}
フィードバック
フィードバックの送信と表示