Share via

Microsoft Entra-események

  • Cikk

Ez a cikk a Microsoft Graph API által közzétett Microsoft Entra-események tulajdonságait és sémáját ismerteti. Az eseménysémákról a CloudEvents sémája című témakörben olvashat.

Elérhető eseménytípusok

Ezek az események akkor aktiválódnak, ha egy felhasználót vagy csoportot létrehoznak, frissítenek vagy törölnek a Microsoft Entra-azonosítóban, vagy ha az erőforrásokat a Microsoft Graph API-val használják.

Esemény neve Leírás
Microsoft.Graph.UserUpdated A Microsoft Entra-azonosítóban szereplő felhasználó létrehozásakor vagy frissítésekor aktiválódik.
Microsoft.Graph.UserDeleted Akkor aktiválódik, ha a Microsoft Entra-azonosítóban lévő felhasználó véglegesen törlődik.
Microsoft.Graph.GroupUpdated A Microsoft Entra-azonosítóban lévő csoport létrehozásakor vagy frissítésekor aktiválódik.
Microsoft.Graph.GroupDeleted Akkor aktiválódik, ha a Microsoft Entra-azonosítóban lévő csoport véglegesen törlődik.

Megjegyzés:

Alapértelmezés szerint egy felhasználó vagy csoport törlése csak helyreállítható törlési művelet, ami azt jelenti, hogy a felhasználó vagy csoport törölve van, de a felhasználó vagy csoport objektum továbbra is létezik. A Microsoft Graph frissített eseményt küld a felhasználók helyreállítható törlésekor. Ha véglegesen törölni szeretne egy felhasználót, lépjen a Felhasználók törlése lapra az Azure Portalon, és válassza a Törlés végleg lehetőséget. A csoportok végleges törlésének lépései hasonlóak.

Példaesemény

Esemény aktiválásakor az Event Grid szolgáltatás adatokat küld az eseményről a feliratkozási célhelyeknek. Ez a szakasz egy példát tartalmaz arra, hogy ezek az adatok milyenek lennének az egyes Microsoft Entra-eseményekhez.

Microsoft.Graph.UserUpdated esemény

{
  "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 esemény

{
  "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 esemény

{
  "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 esemény

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

Esemény tulajdonságai

Egy esemény a következő legfelső szintű adatokkal rendelkezik:

Tulajdonság Type Description
source sztring A bérlő eseményforrása. Ez a mező nem írható. Ezt az értéket a Microsoft Graph API biztosítja.
subject sztring Az esemény tárgyra mutató, a közzétevő által megadott elérési út.
type sztring Az eseményforrás egyik eseménytípusa.
time sztring Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján
id sztring Az esemény egyedi azonosítója.
data object Esemény hasznos adatai, amelyek az erőforrás állapotának változásával kapcsolatos adatokat adják meg.
specversion sztring A CloudEvents sémaspecifikációs verziója.

Az adatobjektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Type Description
changeType sztring Az erőforrásállapot-változás típusa.
resource sztring Az az erőforrás-azonosító, amelyhez az eseményt létrehozták.
tenantId sztring A szervezet azonosítója, ahol a felhasználó vagy a csoport megmarad.
clientState sztring A felhasználó által a Graph API-előfizetés létrehozásakor megadott titkos kód.
@odata.type sztring A Graph API változástípusa.
@odata.id sztring Az a Graph API-erőforrás-azonosító, amelyhez az eseményt létrehozták.
id sztring Az az erőforrás-azonosító, amelyhez az eseményt létrehozták.
organizationId sztring A Microsoft Entra bérlőazonosítója.
eventTime sztring Az az időpont, amikor az erőforrás állapota megváltozott.
sequenceNumber sztring Sorszám.
subscriptionExpirationDateTime sztring Az az RFC 3339 formátumú idő, amikor a Graph API-előfizetés lejár.
subscriptionId sztring A Graph API-előfizetés azonosítója.
tenantId sztring A Microsoft Entra bérlőazonosítója.

További lépések