Microsoft Entra-händelser

  • Artikel

Den här artikeln innehåller egenskaper och schema för Microsoft Entra-händelser som publiceras av Microsoft Graph API. En introduktion till händelsescheman finns i CloudEvents-schema.

Tillgängliga händelsetyper

Dessa händelser utlöses när en användare eller grupp skapas, uppdateras eller tas bort i Microsoft Entra-ID eller genom att arbeta över dessa resurser med hjälp av Microsoft Graph API.

Händelsenamn beskrivning
Microsoft.Graph.UserUpdated Utlöses när en användare i Microsoft Entra-ID skapas eller uppdateras.
Microsoft.Graph.UserDeleted Utlöses när en användare i Microsoft Entra-ID tas bort permanent.
Microsoft.Graph.GroupUpdated Utlöses när en grupp i Microsoft Entra-ID skapas eller uppdateras.
Microsoft.Graph.GroupDeleted Utlöses när en grupp i Microsoft Entra-ID tas bort permanent.

Kommentar

Som standard är borttagning av en användare eller grupp endast en mjuk borttagningsåtgärd, vilket innebär att användaren eller gruppen markeras som borttagen men att användar- eller gruppobjektet fortfarande finns. Microsoft Graph skickar en uppdaterad händelse när användare tas bort mjukt. Om du vill ta bort en användare permanent går du till sidan Ta bort användare i Azure-portalen och väljer Ta bort permanent. Stegen för att ta bort en grupp permanent liknar dem.

Exempelhändelse

När en händelse utlöses skickar Event Grid-tjänsten data om händelsen till prenumererande mål. Det här avsnittet innehåller ett exempel på hur dessa data skulle se ut för varje Microsoft Entra-händelse.

Microsoft.Graph.UserUpdated-händelse

{
  "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-händelse

{
  "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-händelse

{
  "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-händelse

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

Händelseegenskaper

En händelse har följande data på den översta nivån:

Property Type Description
source sträng Klienthändelsekällan. Det här fältet kan inte skrivas. Microsoft Graph API tillhandahåller det här värdet.
subject sträng Utgivardefinierad sökväg till händelseobjektet.
type sträng En av händelsetyperna för den här händelsekällan.
time sträng Den tid då händelsen genereras baserat på leverantörens UTC-tid
id sträng Unik identifierare för händelsen.
data objekt Händelsenyttolast som innehåller data om resurstillståndsändringen.
specversion sträng CloudEvents schemaspecifikationsversion.

Dataobjektet har följande egenskaper:

Property Type Description
changeType sträng Typ av ändring av resurstillstånd.
resource sträng Resursidentifieraren som händelsen skapades för.
tenantId sträng Organisations-ID:t där användaren eller gruppen finns.
clientState sträng En hemlighet som tillhandahålls av användaren när Graph API-prenumerationen skapas.
@odata.type sträng Ändringstypen för Graph API.
@odata.id sträng Graph API-resursidentifieraren som händelsen skapades för.
id sträng Resursidentifieraren som händelsen skapades för.
organizationId sträng Microsoft Entra-klientidentifieraren.
eventTime sträng Tiden då resurstillståndet ändrades.
sequenceNumber sträng Ett sekvensnummer.
subscriptionExpirationDateTime sträng Tiden i RFC 3339-format där Graph API-prenumerationen upphör att gälla.
subscriptionId sträng Graph API-prenumerationsidentifieraren.
tenantId sträng Microsoft Entra-klientidentifieraren.

Nästa steg