Bagikan melalui

Peristiwa Microsoft ToDo

  • Artikel

Artikel ini menyediakan properti dan skema untuk peristiwa Tugas Microsoft ToDo, yang diterbitkan oleh Microsoft Graph API. Untuk pendahuluan skema peristiwa, lihat skema CloudEvents.

Tipe kejadian yang tersedia

Peristiwa ini dipicu ketika todoTask dibuat, diperbarui, atau dihapus dengan beroperasi melalui sumber daya tersebut menggunakan Microsoft Graph API. Perhatikan bahwa Anda hanya dapat berlangganan perubahan dari daftar tugas tertentu.

Nama kejadian Deskripsi
Microsoft.Graph.ToDoCreated Dipicu saat daftar tugas todoTask di Microsoft ToDo dibuat.
Microsoft.Graph.ToDoUpdated Dipicu saat daftar tugas todoTask di Microsoft ToDo diperbarui.
Microsoft.Graph.ToDoDeleted Dipicu saat daftar tugas todoTask di Microsoft ToDo dihapus.

Contoh peristiwa

Saat kejadian dipicu, layanan Event Grid mengirim data mengenai kejadian tersebut ke tujuan berlangganan. Bagian ini berisi contoh tampilan data tersebut untuk setiap peristiwa Pemberitahuan Keamanan Microsoft.

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

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

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

Properti kejadian

Sebuah peristiwa memiliki data tingkat atas berikut ini:

Properti Tipe Deskripsi
source string Sumber kejadian penyewa. Bidang ini tidak dapat ditulis. API Microsoft Graph menyediakan nilai ini.
subject string Jalur yang ditentukan penerbit ke subjek kejadian.
type string Salah satu jenis kejadian untuk sumber kejadian ini.
time string Waktu kejadian dibuat berdasarkan Waktu Universal Terkoordinasi (UTC) milik penyedia
id string Pengidentifikasi unik untuk peristiwa tersebut.
data object Payload kejadian yang menyediakan data mengenai perubahan status sumber daya.
specversion string Versi spesifikasi skema CloudEvents.

Objek data memiliki properti berikut:

Properti Tipe Deskripsi
changeType string Jenis perubahan status sumber daya.
resource string Pengidentifikasi sumber daya tempat kejadian dimunculkan.
tenantId string ID organisasi tempat pemberitahuan dimunculkan.
clientState string Rahasia yang diberikan oleh pengguna pada saat pembuatan langganan Graph API.
@odata.type string Jenis perubahan Graph API.
@odata.id string Pengidentifikasi sumber daya Graph API tempat kejadian dimunculkan.
id string Pengidentifikasi sumber daya tempat kejadian dimunculkan.
subscriptionExpirationDateTime string Waktu di dalam format RFC 3339 pada saat langganan Graph API kedaluwarsa.
subscriptionId string Pengidentifikasi langganan Graph API.
tenantId string Pengidentifikasi penyewa Microsoft Entra.

Langkah berikutnya