Microsoft Entra-gebeurtenissen
Dit artikel bevat de eigenschappen en het schema voor Microsoft Entra-gebeurtenissen, die worden gepubliceerd door Microsoft Graph API. Zie Het CloudEvents-schema voor een inleiding tot gebeurtenisschema's.
Beschikbare gebeurtenistypen
Deze gebeurtenissen worden geactiveerd wanneer een gebruiker of groep wordt gemaakt, bijgewerkt of verwijderd in Microsoft Entra-id of door deze resources te gebruiken met behulp van Microsoft Graph API.
Gebeurtenisnaam | Beschrijving |
---|---|
Microsoft.Graph.UserUpdated | Geactiveerd wanneer een gebruiker in Microsoft Entra-id wordt gemaakt of bijgewerkt. |
Microsoft.Graph.UserDeleted | Geactiveerd wanneer een gebruiker in Microsoft Entra ID definitief wordt verwijderd. |
Microsoft.Graph.GroupUpdated | Geactiveerd wanneer een groep in Microsoft Entra-id wordt gemaakt of bijgewerkt. |
Microsoft.Graph.GroupDeleted | Geactiveerd wanneer een groep in Microsoft Entra-id definitief wordt verwijderd. |
Notitie
Het verwijderen van een gebruiker of groep is standaard alleen een bewerking voor voorlopig verwijderen, wat betekent dat de gebruiker of groep is gemarkeerd als verwijderd, maar het gebruikers- of groepsobject nog steeds bestaat. Microsoft Graph verzendt een bijgewerkte gebeurtenis wanneer gebruikers voorlopig worden verwijderd. Als u een gebruiker definitief wilt verwijderen, gaat u naar de pagina Gebruikers verwijderen in Azure Portal en selecteert u Definitief verwijderen. Stappen voor het definitief verwijderen van een groep zijn vergelijkbaar.
Voorbeeld van een gebeurtenis
Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis om bestemmingen te abonneren. Deze sectie bevat een voorbeeld van hoe die gegevens eruit zouden zien voor elke Microsoft Entra-gebeurtenis.
Microsoft.Graph.UserUpdated-gebeurtenis
{
"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-gebeurtenis
{
"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-gebeurtenis
{
"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-gebeurtenis
{
"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>
}
}
Eigenschappen van gebeurtenis
Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:
Eigenschap | Type | Omschrijving |
---|---|---|
source |
tekenreeks | De bron van de tenant-gebeurtenis. Dit veld kan niet worden geschreven. Microsoft Graph API biedt deze waarde. |
subject |
tekenreeks | Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp. |
type |
tekenreeks | Een van de gebeurtenistypen voor deze gebeurtenisbron. |
time |
tekenreeks | Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider |
id |
tekenreeks | Unieke id voor de gebeurtenis. |
data |
object | Nettolading van gebeurtenissen die de gegevens over de wijziging van de resourcestatus levert. |
specversion |
tekenreeks | CloudEvents schemaspecificatieversie. |
Het gegevensobject heeft de volgende eigenschappen:
Eigenschap | Type | Omschrijving |
---|---|---|
changeType |
tekenreeks | Het type resourcestatuswijziging. |
resource |
tekenreeks | De resource-id waarvoor de gebeurtenis is gegenereerd. |
tenantId |
tekenreeks | De organisatie-id waar de gebruiker of groep wordt bewaard. |
clientState |
tekenreeks | Een geheim dat door de gebruiker wordt verstrekt op het moment dat het Graph API-abonnement is gemaakt. |
@odata.type |
tekenreeks | Het type Graph API-wijziging. |
@odata.id |
tekenreeks | De Graph API-resource-id waarvoor de gebeurtenis is gegenereerd. |
id |
tekenreeks | De resource-id waarvoor de gebeurtenis is gegenereerd. |
organizationId |
tekenreeks | De Tenant-id van Microsoft Entra. |
eventTime |
tekenreeks | Het tijdstip waarop de resourcestatus is gewijzigd. |
sequenceNumber |
tekenreeks | Een volgnummer. |
subscriptionExpirationDateTime |
tekenreeks | De tijd in RFC 3339-indeling waarop het Graph API-abonnement verloopt. |
subscriptionId |
tekenreeks | De Graph API-abonnements-id. |
tenantId |
tekenreeks | De Tenant-id van Microsoft Entra. |
Volgende stappen
- Zie Het overzicht van partnerevenementen van Azure Event Grid voor een inleiding tot partnerevenementen van Azure Event Grid
- Zie Abonneren op Azure Graph API-gebeurtenissen voor meer informatie over het abonneren op Microsoft Graph API voor het ontvangen van Microsoft Entra-gebeurtenissen.
- Zie gebeurtenis-handlers voor meer informatie over Azure Event Grid-gebeurtenis-handlers.
- Zie Gebeurtenisabonnement en Event Grid-abonnementschema maken voor meer informatie over het maken van een Azure Event Grid-abonnement.
- Zie gebeurtenisfiltering voor informatie over het configureren van een gebeurtenisabonnement om specifieke gebeurtenissen te selecteren die moeten worden geleverd. U kunt ook naar filterevenementen verwijzen.