События Microsoft OneDrive

  • Статья

Эта статья содержит свойства и схему для событий Microsoft OneDrive, опубликованных API Microsoft Graph. Общие сведения о схемах событий см. в разделе Схема CloudEvents.

Доступные типы событий

Эти события активируются при обновлении driveItem путем работы над этими ресурсами с помощью API Microsoft Graph.

Имя события Description
Microsoft.Graph.DriveItemUpdated Это событие активируется при обновлении содержимого в иерархии корневой папки driveItem в OneDrive для бизнеса или корневой папки или вложенной папки driveItem в личном OneDrive пользователя.

Пример события

При активации события служба Сетки событий отправляет данные об этом событии в подписанные точки назначения. В этом разделе содержится пример того, как выглядят эти данные для каждого события 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"
    },    
  }
}

Свойства событий

Событие содержит следующие высокоуровневые данные:

Свойство Type Описание:
source строка Источник событий клиента. Это поле защищено от записи. Это значение предоставляет API Microsoft Graph.
subject строка Определенный издателем путь к субъекту события.
type строка Один из типов событий для этого источника событий.
time строка Время создания события определяется на основе времени поставщика в формате UTC.
id строка Уникальный идентификатор события.
data объект Полезные данные события, предоставляющие данные об изменении состояния ресурса.
specversion строка Версия спецификации схемы CloudEvents.

Объект данных имеет следующие свойства:

Свойство Type Описание:
changeType строка Тип изменения состояния ресурса.
resource строка Идентификатор ресурса, для которого было создано событие.
tenantId строка Идентификатор организации, в которой хранится driveItem.
clientState строка Секрет, предоставленный пользователем при создании подписки API Graph.
@odata.type строка Тип изменения API Graph.
@odata.id строка Идентификатор ресурса API Graph, для которого было создано событие.
id строка Идентификатор ресурса, для которого было создано событие.
subscriptionExpirationDateTime строка Время в формате RFC 3339, в течение которого истекает срок действия подписки API Graph.
subscriptionId строка Идентификатор подписки API Graph.
tenantId строка Идентификатор клиента Microsoft Entra.

Следующие шаги