Události Microsoft Entra

  • Článek

Tento článek obsahuje vlastnosti a schéma pro události Microsoft Entra, které publikuje rozhraní Microsoft Graph API. Úvod do schémat událostí najdete ve schématu CloudEvents.

Dostupné typy událostí

Tyto události se aktivují při vytvoření, aktualizaci nebo odstranění uživatele nebo skupiny v MICROSOFT Entra ID nebo provozem těchto prostředků pomocí rozhraní Microsoft Graph API.

Poznámka:

UserUpdated V současné době se generuje událost nebo GroupUpdated událost při vytvoření uživatele nebo skupiny. Jedná se o známý problém a bude opraven v budoucí verzi.

Název události Popis
Microsoft.Graph.UserUpdated Aktivuje se při vytvoření nebo aktualizaci uživatele v MICROSOFT Entra ID.
Microsoft.Graph.UserDeleted Aktivuje se při trvalém odstranění uživatele v MICROSOFT Entra ID.
Microsoft.Graph.GroupUpdated Aktivuje se při vytvoření nebo aktualizaci skupiny v ID Microsoft Entra.
Microsoft.Graph.GroupDeleted Aktivuje se při trvalém odstranění skupiny v ID Microsoft Entra.

Poznámka:

Odstranění uživatele nebo skupiny je ve výchozím nastavení pouze operace obnovitelného odstranění, což znamená, že uživatel nebo skupina jsou označeny jako odstraněné, ale objekt uživatele nebo skupiny stále existuje. Microsoft Graph odešle aktualizovanou událost při obnovitelném odstranění uživatelů. Pokud chcete uživatele trvale odstranit, přejděte na stránku Odstranit uživatele na webu Azure Portal a vyberte Odstranit trvale. Postup trvalého odstranění skupiny je podobný.

Příklad události

Když se událost aktivuje, služba Event Grid odešle data o této události do odběru cílů. Tato část obsahuje příklad toho, jak by tato data vypadala pro každou událost Microsoft Entra.

Událost 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>
  }
}

Microsoft.Graph.UserDeleted – událost

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

Událost 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>
  }
}

Událost 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>
  }
}

Vlastnosti události

Událost má následující data nejvyšší úrovně:

Vlastnost Type Description
source string Zdroj událostí tenanta. Toto pole není zapisovatelné. Rozhraní Microsoft Graph API tuto hodnotu poskytuje.
subject string Cesta k předmětu události, kterou definuje vydavatel.
type string Jeden z typů událostí pro tento zdroj událostí.
time string Čas vygenerování události na základě času UTC poskytovatele
id string Jedinečný identifikátor události.
data objekt Datová část události, která poskytuje data o změně stavu prostředku.
specversion string Verze specifikace schématu CloudEvents

Datový objekt má následující vlastnosti:

Vlastnost Type Description
changeType string Typ změny stavu prostředku.
resource string Identifikátor prostředku, pro který byla událost vyvolána.
tenantId string ID organizace, ve kterém se uživatel nebo skupina uchovávají.
clientState string Tajný kód poskytnutý uživatelem v době vytvoření předplatného rozhraní Graph API
@odata.type string Typ změny rozhraní Graph API.
@odata.id string Identifikátor prostředku rozhraní Graph API, pro který byla událost vyvolána.
id string Identifikátor prostředku, pro který byla událost vyvolána.
organizationId string Identifikátor tenanta Microsoft Entra.
eventTime string Čas, kdy se stav prostředku změnil.
sequenceNumber string Pořadové číslo.
subscriptionExpirationDateTime string Čas ve formátu RFC 3339 , kdy vyprší platnost předplatného rozhraní Graph API.
subscriptionId string Identifikátor předplatného rozhraní Graph API.
tenantId string Identifikátor tenanta Microsoft Entra.

Další kroky

  • Úvod k partnerským událostem Azure Event Gridu najdete v tématu Přehled partnerských událostí.
  • Informace o přihlášení k odběru rozhraní Microsoft Graph API pro příjem událostí Microsoft Entra najdete v tématu přihlášení k odběru událostí rozhraní Azure Graph API.
  • Informace o obslužných rutinách událostí Azure Event Gridu najdete v tématu Obslužné rutiny událostí.
  • Další informace o vytvoření odběru služby Azure Event Grid najdete v tématu vytvoření odběru událostí a schématu odběru služby Event Grid.
  • Informace o tom, jak nakonfigurovat odběr událostí tak, aby vybral konkrétní události, které se mají doručit, najdete v tématu Filtrování událostí.