События Microsoft Entra

  • Статья

Эта статья содержит свойства и схему для событий Microsoft Entra, опубликованных API Microsoft Graph. Общие сведения о схемах событий см. в разделе Схема CloudEvents.

Доступные типы событий

Эти события активируются при создании, обновлении или удалении пользователя или группы в идентификаторе Microsoft Entra или работе над этими ресурсами с помощью API Microsoft Graph.

Имя события Description
Microsoft.Graph.UserUpdated Активируется при создании или обновлении пользователя в идентификаторе Microsoft Entra.
Microsoft.Graph.UserDeleted Активируется при окончательном удалении пользователя в идентификаторе Microsoft Entra.
Microsoft.Graph.GroupUpdated Активируется при создании или обновлении группы в идентификаторе Microsoft Entra.
Microsoft.Graph.GroupDeleted Активируется при окончательном удалении группы в идентификаторе Microsoft Entra.

Примечание.

По умолчанию удаление пользователя или группы является только операцией обратимого удаления, что означает, что пользователь или группа помечены как удаленные, но объект пользователя или группы по-прежнему существует. Microsoft Graph отправляет обновленное событие при обратимом удалении пользователей. Чтобы окончательно удалить пользователя, перейдите на страницу "Удалить пользователей" в портал Azure и выберите "Удалить окончательно". Действия по окончательному удалению группы похожи.

Пример события

При активации события служба Сетки событий отправляет данные об этом событии в подписанные точки назначения. В этом разделе содержится пример того, как выглядят эти данные для каждого события Microsoft Entra.

Событие 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

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

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

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

Свойства событий

Событие содержит следующие высокоуровневые данные:

Свойство Тип Описание:
source строка Источник событий клиента. Это поле защищено от записи. Это значение предоставляет API Microsoft Graph.
subject строка Определенный издателем путь к субъекту события.
type строка Один из типов событий для этого источника событий.
time строка Время создания события определяется на основе времени поставщика в формате UTC.
id строка Уникальный идентификатор события.
data объект Полезные данные события, предоставляющие данные об изменении состояния ресурса.
specversion строка Версия спецификации схемы CloudEvents.

Объект данных имеет следующие свойства:

Свойство Тип Описание:
changeType строка Тип изменения состояния ресурса.
resource строка Идентификатор ресурса, для которого было создано событие.
tenantId строка Идентификатор организации, в которой хранится пользователь или группа.
clientState строка Секрет, предоставленный пользователем при создании подписки API Graph.
@odata.type строка Тип изменения API Graph.
@odata.id строка Идентификатор ресурса API Graph, для которого было создано событие.
id строка Идентификатор ресурса, для которого было создано событие.
organizationId строка Идентификатор клиента Microsoft Entra.
eventTime строка Время изменения состояния ресурса.
sequenceNumber строка Порядковый номер.
subscriptionExpirationDateTime строка Время в формате RFC 3339, в течение которого истекает срок действия подписки API Graph.
subscriptionId строка Идентификатор подписки API Graph.
tenantId строка Идентификатор клиента Microsoft Entra.

Следующие шаги