Bagikan melalui

Peristiwa Microsoft Entra

  • Artikel

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

Tipe kejadian yang tersedia

Peristiwa ini dipicu saat Pengguna atau Grup dibuat, diperbarui, atau dihapus di ID Microsoft Entra atau dengan mengoperasikan sumber daya tersebut menggunakan Microsoft Graph API.

Catatan

Saat ini, UserUpdated atau GroupUpdated peristiwa dihasilkan saat pengguna atau grup dibuat. Ini adalah masalah yang diketahui dan akan diperbaiki dalam rilis mendatang.

Nama kejadian Deskripsi
Microsoft.Graph.UserUpdated Dipicu saat pengguna di ID Microsoft Entra dibuat atau diperbarui.
Microsoft.Graph.UserDeleted Dipicu saat pengguna di ID Microsoft Entra dihapus secara permanen.
Microsoft.Graph.GroupUpdated Dipicu saat grup di ID Microsoft Entra dibuat atau diperbarui.
Microsoft.Graph.GroupDeleted Dipicu saat grup di ID Microsoft Entra dihapus secara permanen.

Catatan

Secara default, menghapus pengguna atau grup hanyalah operasi penghapusan sementara, yang berarti bahwa pengguna atau grup ditandai sebagai dihapus tetapi objek pengguna atau grup masih ada. Microsoft Graph mengirimkan peristiwa yang diperbarui saat pengguna dihapus sementara. Untuk menghapus pengguna secara permanen, navigasikan ke halaman Hapus pengguna di portal Azure dan pilih Hapus secara permanen. Langkah-langkah untuk menghapus grup secara permanen serupa.

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 Microsoft Entra.

Kejadian Microsoft.Graph.UserUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.UserUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Users/<user-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "updated",
    "clientState": "<guid>",
    "resource": "Users/<user-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.User",
      "@odata.id": "Users/<user-id>",
      "id": "<user-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

Kejadian Microsoft.Graph.UserDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.UserDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Users/<user-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "deleted",
    "clientState": "<guid>",
    "resource": "Users/<user-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.User",
      "@odata.id": "Users/<user-id>",
      "id": "<user-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

Kejadian Microsoft.Graph.GroupUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.GroupUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Groups/<group-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "updated",
    "clientState": "<guid>",
    "resource": "Groups/<group-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.Group",
      "@odata.id": "Groups/<group-id>",
      "id": "<group-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

Kejadian Microsoft.Graph.GroupDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.GroupDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Groups/<group-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "deleted",
    "clientState": "<guid>",
    "resource": "Groups/<group-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.Group",
      "@odata.id": "Groups/<group-id>",
      "id": "<group-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

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 pengguna atau grup disimpan.
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.
organizationId string Pengidentifikasi penyewa Microsoft Entra.
eventTime string Waktu ketika status sumber daya berubah.
sequenceNumber string Sebuah nomor urut.
subscriptionExpirationDateTime string Waktu dalam format Request for Comments (RFC) 3339 di mana langganan Graph API kedaluwarsa.
subscriptionId string Pengidentifikasi langganan Graph API.
tenantId string Pengidentifikasi penyewa Microsoft Entra.

Konten terkait