Поделиться через

События Microsoft ToDo

  • Статья

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

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

Эти события активируются при создании, обновлении или удалении todoTask с помощью API Microsoft Graph. Обратите внимание, что вы можете подписаться только на изменения из определенного списка задач.

Имя события Description
Microsoft.Graph.ToDoCreated Активируется при создании списка задач todoTask в списке задач Microsoft ToDo.
Microsoft.Graph.ToDoUpdated Активируется при обновлении списка задач todoTask в списке задач Microsoft ToDo.
Microsoft.Graph.ToDoDeleted Активируется при удалении списка задач todoTask в списке задач Microsoft ToDo.

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

При активации события служба Сетки событий отправляет данные об этом событии в подписанные точки назначения. В этом разделе содержится пример того, как будут выглядеть эти данные для каждого события оповещения системы безопасности Майкрософт.

Событие Microsoft.Graph.ToDoCreated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoCreated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Created",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

Событие Microsoft.Graph.ToDoUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Updated",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

Событие Microsoft.Graph.ToDoDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Deleted",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
     "id": "<ToDoTask-id>",
     "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

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

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

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

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

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

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