Microsoft Sharepoint イベント
この記事では、Microsoft Graph API によって公開される Microsoft Sharepoint イベントのプロパティとスキーマについて説明します。 イベント スキーマの概要については、CloudEvents スキーマに関する記事を参照してください。
使用可能なイベントの種類
これらのイベントは、Microsoft Graph API を使用してこれらのリソースを 操作することによって listItem が更新されたときにトリガーされます。
イベント名 | 説明 |
---|---|
Microsoft.Graph.ListUpdated | Microsoft Sharepoint のリストが更新されたときにトリガーされます。 |
イベントの例
イベントがトリガーされると、Event Grid サービスにより、そのイベントに関するデータがサブスクライブしている宛先に送信されます。 このセクションでは、各 Microsoft Sharepoint イベントのデータの外観の例を示します。
Microsoft.Graph.ListUpdated イベント
{
"id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
"type": "Microsoft.Graph.ListUpdated",
"source": "/tenants/<tenant-id>/applications/<application-id>",
"subject": "listItem/<listItem-id>",
"time": "2022-05-24T22:24:31.3062901Z",
"datacontenttype": "application/json",
"specversion": "1.0",
"data": {
"subscriptionId": "<microsoft-graph-subscription-id>",
"tenantId": "<tenant-id>",
"clientState": "<user-provided secret>",
"expirationDateTime": "2023-10-05T18:11:08.587Z",
"resource": "<guid>",
"siteUrl": "<relative path>",
"webId": "<guid>",
"resourceData": {
"@odata.type": "#Microsoft.Graph.listItem"
},
}
}
イベントのプロパティ
イベントのトップレベルのデータを次に示します。
プロパティ | タイプ | 説明 |
---|---|---|
source |
string | テナント イベント ソース。 このフィールドは書き込み可能ではありません。 この値は Microsoft Graph API によって指定されます。 |
subject |
string | 発行元が定義したイベントの対象のパス。 |
type |
string | このイベント ソース用イベントの種類のいずれか。 |
time |
string | プロバイダーの UTC 時刻に基づくイベントの生成時刻。 |
id |
string | イベントの一意識別子。 |
data |
object | リソースの状態変更に関するデータを提供するイベント ペイロード。 |
specversion |
string | CloudEvents スキーマ仕様バージョン。 |
データ オブジェクトには、次のプロパティがあります。
プロパティ | タイプ | 説明 |
---|---|---|
changeType |
string | リソースの状態変更の種類。 |
resource |
string | イベントが発生したリソースの識別子。 |
tenantId |
string | リストが保持されている組織 ID。 |
clientState |
string | Graph API サブスクリプションの作成時にユーザーが指定したシークレット。 |
@odata.type |
string | Graph API の変更の種類。 |
@odata.id |
string | イベントが発生した Graph API リソースの識別子。 |
id |
string | イベントが発生したリソースの識別子。 |
subscriptionExpirationDateTime |
string | Graph API サブスクリプションが期限切れになる RFC 3339 形式の時刻。 |
subscriptionId |
string | Graph API サブスクリプション識別子。 |
tenantId |
string | Microsoft Entra テナント識別子。 |
次のステップ
- Azure Event Grid のパートナー イベントの概要については、パートナー イベントの概要に関する記事を参照してください。
- イベントを受信するために Microsoft Graph API をサブスクライブする方法については、Microsoft Graph API イベントのサブスクライブを参照してください。
- Azure Event Grid イベント ハンドラーの詳細については、イベント ハンドラーに関する記事を参照してください。
- Azure Event Grid サブスクリプションの作成の詳細については、「イベント サブスクリプションの作成」と「Event Grid サブスクリプション スキーマ」を参照してください。
- 配信する特定のイベントを選ぶようにイベント サブスクリプションを構成する方法の詳細については、イベントのフィルター処理に関する記事を参照してください。 フィルター イベントを参照することもできます。