Peristiwa Microsoft Entra
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
- Untuk pengenalan Acara Mitra Azure Event Grid, lihat gambaran umum Acara Mitra
- Untuk informasi tentang cara berlangganan Microsoft Graph API untuk menerima peristiwa Microsoft Entra, lihat berlangganan peristiwa Azure Graph API.
- Untuk informasi selengkapnya tentang cara membuat langganan Azure Event Grid, lihat membuat langganan kejadian dan skema langganan Event Grid.