次の方法で共有

Microsoft OneDrive イベント

この記事では、Microsoft Graph API によって公開される Microsoft OneDrive イベントのプロパティとスキーマについて説明します。 イベント スキーマの概要については、 CloudEvents スキーマに関するページを参照してください。

使用可能なイベントの種類

これらのイベントは、Microsoft Graph API を使用してそれらのリソースを操作することによって driveItem が更新されたときにトリガーされます。

イベント名 [説明]
Microsoft.Graph.DriveItemUpdated このイベントは、OneDrive for Business のルート フォルダー driveItem の階層内のコンテンツ、またはユーザーの個人用 OneDrive のルート フォルダーまたはサブフォルダー driveItem のコンテンツが更新されたときにトリガーされます。

イベントの例

イベントがトリガーされると、Event Grid サービスはそのイベントに関するデータをサブスクライブ先に送信します。 このセクションでは、各 Microsoft OneDrive イベントのデータの例を示します。

Microsoft.Graph.DriveItemUpdated イベント

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.DriveItemUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "driveItem/<driveItem-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": "<sharepoint relative URL>",
    "webId": "<guid>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.driveItem"
    },    
  }
}

イベントのプロパティ

イベントのトップレベルのデータを次に示します。

プロパティ タイプ [説明]
source 文字列 テナントイベントソース。 このフィールドは書き込み可能ではありません。 Microsoft Graph API は、この値を提供します。
subject 文字列 発行元が定義したイベントの対象のパス。
type 文字列 このイベント ソースのイベントの種類の 1 つ。
time 文字列 プロバイダーの UTC 時刻に基づいてイベントが生成される時間
id 文字列 イベント専用の識別子。
data オブジェクト リソース状態の変化に関するデータを提供するイベント ペイロード。
specversion 文字列 CloudEvents スキーマ仕様バージョン。

データ オブジェクトには、次のプロパティがあります。

プロパティ タイプ [説明]
changeType 文字列 リソースの状態変更の種類。
resource 文字列 イベントが発生したリソース識別子。
tenantId 文字列 driveItem が保持されている組織 ID。
clientState 文字列 Graph API サブスクリプションの作成時にユーザーによって提供されたシークレット。
@odata.type 文字列 Graph API の変更の種類。
@odata.id 文字列 イベントが発生した Graph API リソース識別子。
id 文字列 イベントが発生したリソース識別子。
subscriptionExpirationDateTime 文字列 Graph API サブスクリプションの有効期限が切れる RFC 3339 形式の時刻。
subscriptionId 文字列 Graph API サブスクリプション識別子。
tenantId 文字列 Microsoft Entra テナント識別子。

次のステップ

  • Last updated on