Události Microsoft Entra

Článek
06/14/2024

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í.

Sdílet prostřednictvím