Udostępnij za pośrednictwem

Zdarzenia firmy Microsoft Entra

  • Artykuł

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

Dostępne typy zdarzeń

Te zdarzenia są wyzwalane po utworzeniu, zaktualizowaniu lub usunięciu użytkownika lub grupy w identyfikatorze Entra firmy Microsoft lub przez działanie tych zasobów przy użyciu interfejsu API programu Microsoft Graph.

Uwaga

UserUpdated Obecnie lub GroupUpdated zdarzenie jest generowane po utworzeniu użytkownika lub grupy. Jest to znany problem i zostanie rozwiązany w przyszłej wersji.

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 po utworzeniu lub zaktualizowaniu grupy w identyfikatorze Entra firmy Microsoft.
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 tylko operacją usuwania nietrwałego, co oznacza, że użytkownik lub grupa jest oznaczona jako usunięta, ale nadal istnieje obiekt użytkownika lub grupy. Program Microsoft Graph wysyła zaktualizowane zdarzenie, gdy użytkownicy są nietrwale usuwani. Aby trwale usunąć użytkownika, przejdź do strony Usuń użytkowników w witrynie Azure Portal i wybierz pozycję Usuń trwale. Kroki trwałego usunięcia grupy są podobne.

Przykładowe zdarzenie

Po wyzwoleniu zdarzenia usługa Event Grid wysyła dane o tym zdarzeniu do subskrybowania miejsc docelowych. Ta sekcja zawiera przykład tego, jak wyglądają te dane dla każdego zdarzenia Firmy Microsoft Entra.

Zdarzenie 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>
  }
}

Zdarzenie 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>
  }
}

Zdarzenie 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>
  }
}

Zdarzenie 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>
  }
}

Właściwości zdarzenia

Zdarzenie ma następujące dane najwyższego poziomu:

Właściwość Type opis
source string Źródło zdarzeń dzierżawy. To pole nie jest możliwe do zapisu. Interfejs API programu Microsoft Graph zapewnia tę wartość.
subject string Zdefiniowana przez wydawcę ścieżka do tematu zdarzenia.
type string Jeden z typów zdarzeń dla tego źródła zdarzeń.
time string Czas generowania zdarzenia na podstawie czasu UTC dostawcy
id string Unikatowy identyfikator zdarzenia.
data obiekt Ładunek zdarzenia, który dostarcza dane dotyczące zmiany stanu zasobu.
specversion string Wersja specyfikacji schematu CloudEvents.

Obiekt danych ma następujące właściwości:

Właściwość Type opis
changeType string Typ zmiany stanu zasobu.
resource string Identyfikator zasobu, dla którego zostało zgłoszone zdarzenie.
tenantId string Identyfikator organizacji, w którym jest przechowywany użytkownik lub grupa.
clientState string Wpis tajny dostarczony przez użytkownika podczas tworzenia subskrypcji interfejsu API programu Graph.
@odata.type string Typ zmiany interfejsu API programu Graph.
@odata.id string Identyfikator zasobu interfejsu API programu Graph, dla którego zostało zgłoszone zdarzenie.
id string Identyfikator zasobu, dla którego zostało zgłoszone zdarzenie.
organizationId string Identyfikator dzierżawy entra firmy Microsoft.
eventTime string Czas zmiany stanu zasobu.
sequenceNumber string Numer sekwencji.
subscriptionExpirationDateTime string Czas w formacie RFC 3339 , w którym wygasa subskrypcja interfejsu API programu Graph.
subscriptionId string Identyfikator subskrypcji interfejsu API programu Graph.
tenantId string Identyfikator dzierżawy entra firmy Microsoft.

Następne kroki

  • Aby zapoznać się z wprowadzeniem do zdarzeń partnerskich usługi Azure Event Grid, zobacz Omówienie zdarzeń partnerskich
  • Aby uzyskać informacje na temat subskrybowania interfejsu API programu Microsoft Graph w celu odbierania zdarzeń firmy Microsoft Entra, zobacz subskrybowanie zdarzeń interfejsu API programu Azure Graph.
  • Aby uzyskać informacje o programach obsługi zdarzeń usługi Azure Event Grid, zobacz Programy obsługi zdarzeń.
  • Aby uzyskać więcej informacji na temat tworzenia subskrypcji usługi Azure Event Grid, zobacz tworzenie subskrypcji zdarzeń i schematu subskrypcji usługi Event Grid.
  • Aby uzyskać informacje o sposobie konfigurowania subskrypcji zdarzeń w celu wybrania określonych zdarzeń do dostarczenia, zobacz filtrowanie zdarzeń.