Microsoft ToDo 事件

  • 發行項

本文說明 Microsoft ToDo 事件的屬性和結構描述，這些事件是由 Microsoft Graph API 所發佈。 如需事件結構描述簡介，請參閱 CloudEvents 結構描述。

可用的事件類型

建立、更新或刪除 todoTask 時，或使用 Microsoft Graph API 操作這些資源，即會觸發這些事件。 請注意，您只能訂閱特定工作清單中的變更。

事件名稱 描述
Microsoft.Graph.ToDoCreated 在 Microsoft ToDo 工作清單中建立 todoTask 時即會觸發。
Microsoft.Graph.ToDoUpdated 在 Microsoft ToDo 工作清單中更新 todoTask 時即會觸發。
Microsoft.Graph.ToDoDeleted 在 Microsoft ToDo 工作清單中刪除 todoTask 時即會觸發。

事件範例

觸發事件時，事件格線服務會將該事件的相關資料傳送至訂閱目的地。 本節包含每個 Microsoft 安全性警示事件的資料外觀範例。

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"
    }
  }
}

事件屬性

事件具有下列的最高層級資料：

屬性 類型​ 描述
source string 租用戶事件來源。 此欄位無法寫入。 Microsoft 圖形 API 提供此值。
subject string 發行者定義事件主旨的路徑。
type string 此事件來源的其中一種事件類型。
time string 事件產生的時間，以提供者之 UTC 時間為準
id string 事件的唯一識別碼。
data object 提供關於資源狀態變更之資料的事件承載。
specversion string CloudEvents 結構描述規格版本。

資料物件具有下列屬性：

屬性 類型​ 描述
changeType string 資源狀態變更的類型。
resource string 引起事件的資源識別碼。
tenantId string 引發警示的組織識別碼。
clientState string 使用者在建立圖形 API 訂用帳戶時所提供的祕密。
@odata.type string 圖形 API 變更類型。
@odata.id string 引起事件的圖形 API 資源識別碼。
id string 引起事件的資源識別碼。
subscriptionExpirationDateTime string 圖形 API 訂用帳戶到期的時間 (格式為 RFC 3339)。
subscriptionId string 圖形 API 訂用帳戶識別碼。
tenantId string Microsoft Entra 租用戶識別碼。

下一步