Microsoft Entra olayları

  • Makale

Bu makalede, Microsoft Graph API tarafından yayımlanan Microsoft Entra olaylarının özellikleri ve şeması sağlanır. Olay şemalarına giriş için bkz . CloudEvents şeması.

Kullanılabilir olay türleri

Bir Kullanıcı veya Grup Microsoft Entra Kimliği'nde oluşturulduğunda, güncelleştirildiğinde veya silindiğinde ya da Microsoft Graph API'si kullanılarak bu kaynaklar üzerinde çalıştırıldığında bu olaylar tetiklenir.

Not

UserUpdated Şu anda veya bir kullanıcı veya GroupUpdated grup oluşturulduğunda olay oluşturulur. Bu bilinen bir sorundur ve gelecek sürümde düzeltilecektir.

Olay adı Açıklama
Microsoft.Graph.UserUpdated Microsoft Entra Id içindeki bir kullanıcı oluşturulduğunda veya güncelleştirildiğinde tetiklendi.
Microsoft.Graph.UserDeleted Microsoft Entra Id içindeki bir kullanıcı kalıcı olarak silindiğinde tetikleniyor.
Microsoft.Graph.GroupUpdated Microsoft Entra Id içindeki bir grup oluşturulduğunda veya güncelleştirildiğinde tetiklendi.
Microsoft.Graph.GroupDeleted Microsoft Entra Id içindeki bir grup kalıcı olarak silindiğinde tetikleniyor.

Not

Varsayılan olarak, bir kullanıcı veya grubu silmek yalnızca geçici silme işlemidir; bu da kullanıcı veya grubun silinmiş olarak işaretlendiği ancak kullanıcı veya grup nesnesinin hala mevcut olduğu anlamına gelir. Kullanıcılar geçici olarak silindiğinde Microsoft Graph güncelleştirilmiş bir olay gönderir. Bir kullanıcıyı kalıcı olarak silmek için Azure portalında Kullanıcıları sil sayfasına gidin ve Kalıcı olarak sil'i seçin. Bir grubu kalıcı olarak silme adımları benzerdir.

Örnek olay

Bir olay tetiklendiğinde, Event Grid hizmeti bu olayla ilgili verileri abone olan hedeflere gönderir. Bu bölüm, her Microsoft Entra olayı için bu verilerin nasıl görüneceğine ilişkin bir örnek içerir.

Microsoft.Graph.UserUpdated olayı

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

Microsoft.Graph.UserDeleted olayı

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

Microsoft.Graph.GroupUpdated olayı

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

Microsoft.Graph.GroupDeleted olayı

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

Olay özellikleri

Bir olay aşağıdaki üst düzey verilere sahiptir:

Özellik Türü Veri Akışı Açıklaması
source Dize Kiracı olay kaynağı. Bu alan yazılabilir değil. Microsoft Graph API'sinde bu değer sağlanır.
subject Dize Olay konusunun yayımcı tarafından tanımlanan yolu.
type Dize Bu olay kaynağı için olay türlerinden biri.
time Dize Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat
id Dize Olayın benzersiz tanımlayıcısı.
data nesne Kaynak durumu değişikliği hakkındaki verileri sağlayan olay yükü.
specversion Dize CloudEvents şema belirtimi sürümü.

Veri nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
changeType Dize Kaynak durumu değişikliğinin türü.
resource Dize Olayın oluşturulduğu kaynak tanımlayıcısı.
tenantId Dize Kullanıcının veya grubun tutulduğu kuruluş kimliği.
clientState Dize Graph API aboneliği oluşturulurken kullanıcı tarafından sağlanan gizli dizi.
@odata.type Dize Graph API'sinin değişiklik türü.
@odata.id Dize Olayın oluşturulduğu Graph API kaynak tanımlayıcısı.
id Dize Olayın oluşturulduğu kaynak tanımlayıcısı.
organizationId Dize Microsoft Entra kiracı tanımlayıcısı.
eventTime Dize Kaynak durumunun değiştiği saat.
sequenceNumber Dize Bir sıra numarası.
subscriptionExpirationDateTime Dize Rfc 3339 biçimindeki Graph API aboneliğinin süresinin dolma zamanı.
subscriptionId Dize Graph API abonelik tanımlayıcısı.
tenantId Dize Microsoft Entra kiracı tanımlayıcısı.

Sonraki adımlar