次の方法で共有

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 string テナント イベント ソース。 このフィールドは書き込み可能ではありません。 この値は Microsoft Graph API によって指定されます。
subject string 発行元が定義したイベントの対象のパス。
type string このイベント ソース用イベントの種類のいずれか。
time string プロバイダーの UTC 時刻に基づくイベントの生成時刻。
id string イベントの一意識別子。
data object リソースの状態変更に関するデータを提供するイベント ペイロード。
specversion string CloudEvents スキーマ仕様バージョン。

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

プロパティ タイプ 説明
changeType string リソースの状態変更の種類。
resource string イベントが発生したリソースの識別子。
tenantId string driveItem が保持されている組織 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 テナント識別子。

次のステップ