Microsoft Entra: typy zdarzeń i schemat w usłudze Azure Event Grid

Ten artykuł zawiera właściwości i schemat zdarzeń firmy Microsoft Entra publikowanych przez interfejs API programu Microsoft Graph. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat CloudEvents.

Dostępne typy zdarzeń Microsoft Entra

Interfejs API Microsoft Graph publikuje w usłudze Azure Event Grid następujące zdarzenia Microsoft Entra. Te zdarzenia są wyzwalane po utworzeniu, zaktualizowaniu lub usunięciu użytkownika lub grupy w Microsoft Entra ID lub modyfikacji tych zasobów za pośrednictwem usługi Microsoft interfejs Graph API.

Uwaga

Obecnie występuje znany problem, który powoduje, że podczas tworzenia użytkownika lub grupy generowane jest zdarzenie UserUpdated lub GroupUpdated.

Nazwa zdarzenia Opis
Microsoft.Graph.UserUpdated Wyzwalane po utworzeniu lub zaktualizowaniu użytkownika w usłudze Microsoft Entra ID.
Microsoft.Graph.UserDeleted Wyzwalane, gdy użytkownik w identyfikatorze Entra firmy Microsoft zostanie trwale usunięty.
Microsoft.Graph.GroupUpdated Wyzwalane, gdy grupa w usłudze Microsoft Entra ID zostanie utworzona lub zaktualizowana.
Microsoft.Graph.GroupDeleted Wyzwalane, gdy grupa w identyfikatorze Entra firmy Microsoft zostanie trwale usunięta.

Uwaga

Domyślnie usunięcie użytkownika lub grupy jest operacją miękkiego usunięcia. Użytkownik lub grupa jest oznaczona jako usunięta, ale obiekt użytkownika lub grupy nadal istnieje. Interfejs API Microsoft Graph wysyła zdarzenie UserUpdated lub GroupUpdated, gdy użytkownik lub grupa zostaną usunięci nietrwale. Aby trwale usunąć użytkownika, przejdź do strony Usuń użytkowników w portalu Azure i wybierz pozycję Usuń trwale. Kroki trwałego usunięcia grupy są podobne.

przykłady zdarzeń Microsoft Entra

Gdy zostanie wyzwolone zdarzenie Microsoft Entra, usługa Azure Event Grid wysyła dane o tym zdarzeniu do subskrybujących miejsc docelowych. W poniższych sekcjach przedstawiono przykładowe ładunki JSON dla każdego typu zdarzenia.

Zdarzenie Microsoft.Graph.UserUpdated

{
  "id": "0000aaaa-11bb-cccc-dd22-eeeeee333333",
  "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>"
  }
}

Zdarzenie Microsoft.Graph.UserDeleted

{
  "id": "1111bbbb-22cc-dddd-ee33-ffffff444444",
  "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>"
  }
}

Zdarzenie Microsoft.Graph.GroupUpdated

{
  "id": "2222cccc-33dd-eeee-ff44-aaaaaa555555",
  "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>"
  }
}

Zdarzenie Microsoft.Graph.GroupDeleted

{
  "id": "3333dddd-44ee-ffff-aa55-bbbbbbbb6666",
  "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>"
  }
}

Właściwości zdarzeń Microsoft Entra

Zdarzenie Microsoft Entra ma następujące właściwości najwyższego poziomu:

Właściwość Typ Opis
source ciąg Źródło zdarzeń dzierżawcy. To pole nie jest zapisywalne. Interfejs API programu Microsoft Graph zapewnia tę wartość.
subject ciąg Ścieżka do obiektu zdarzenia zdefiniowana przez wydawcę.
type ciąg Jeden z typów zdarzeń dla tego źródła zdarzeń.
time ciąg Czas wygenerowania zdarzenia na podstawie czasu UTC dostawcy.
id ciąg Unikatowy identyfikator zdarzenia.
data obiekt Ładunek zdarzenia zawierający dane o zmianie stanu zasobu.
specversion ciąg Wersja specyfikacji schematu CloudEvents.

Właściwości obiektu danych

Obiekt data w zdarzeniu Microsoft Entra ma następujące właściwości:

Właściwość Typ Opis
changeType ciąg Typ zmiany stanu zasobu, taki jak created, updatedlub deleted.
resource ciąg Identyfikator zasobu, dla którego zostało zgłoszone zdarzenie.
clientState ciąg Wpis tajny, który należy podać podczas tworzenia subskrypcji usługi Microsoft interfejs Graph API.
@odata.type ciąg Typ zmiany interfejsu API Microsoft Graph.
@odata.id ciąg Identyfikator zasobu interfejs Graph API firmy Microsoft, dla którego zostało zgłoszone zdarzenie.
id ciąg Identyfikator zasobu, dla którego zostało zgłoszone zdarzenie.
organizationId ciąg Identyfikator dzierżawy Microsoft Entra.
eventTime ciąg Czas zmiany stanu zasobu.
sequenceNumber ciąg Numer sekwencji.
subscriptionExpirationDateTime ciąg Czas w formacie Request for Comments (RFC) 3339, o której wygasa subskrypcja interfejsu API Microsoft Graph.
subscriptionId ciąg Identyfikator subskrypcji usługi Microsoft interfejs Graph API.
tenantId ciąg Identyfikator dzierżawcy Microsoft Entra.

Powiązana zawartość

  • Ostatnia aktualizacja o