Поделиться через

Получение customSecurityAttributeAudit

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) CustomSecAttributeAuditLogs.Read.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение CustomSecAttributeAuditLogs.Read.All Недоступно.

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие привилегированные роли.

  • Средство чтения журнала атрибутов
  • Администратор журнала атрибутов

По умолчанию глобальный администратор и другие роли администратора не имеют разрешений на чтение журналов аудита настраиваемых атрибутов безопасности.

HTTP-запрос

GET /auditLogs/customSecurityAttributeAudits/{customSecurityAttributeAuditId}

Необязательные параметры запросов

Этот метод не поддерживает параметры запроса OData для настройки ответа. Общие сведения см. в статье Параметры запроса OData.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект customSecurityAttributeAudit в теле отклика.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/auditLogs/customSecurityAttributeAudits/Directory_46ef8262-896f-4a39-9666-db82e22e778b_GXP3K_386490241

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#auditLogs/customSecurityAttributeAudits/$entity",
   "id": "Directory_46ef8262-896f-4a39-9666-db82e22e778b_GXP3K_386490241",
   "category": "AttributeManagement",
   "correlationId": "f3b07799-da67-4a79-bb56-eed7ba2ca404",
   "result": "success",
   "resultReason": "",
   "activityDisplayName": "Update an attribute set",
   "activityDateTime": "2023-07-27T00:36:52.014638Z",
   "loggedByService": "Core Directory",
   "operationType": "Update",
   "userAgent": null,
   "initiatedBy": {
       "app": null,
       "user": {
           "id": "573bfb22-436c-40c7-82c2-d1b67677c33c",
           "displayName": null,
           "userPrincipalName": "admin1@contoso.com",
           "ipAddress": "{ipAddress}",
           "userType": null,
           "homeTenantId": null,
           "homeTenantName": null
       }
   },
   "targetResources": [
       {
           "id": "dd707ff2-fd98-4ce5-9733-eafa781d3b12",
           "displayName": "DesignTest",
           "type": "Other",
           "userPrincipalName": null,
           "groupType": null,
           "modifiedProperties": [
               {
                   "displayName": "MaxAttributesPerSet",
                   "oldValue": "[25]",
                   "newValue": "[20]"
               },
               {
                   "displayName": "Included Updated Properties",
                   "oldValue": null,
                   "newValue": "\"MaxAttributesPerSet\""
               }
           ]
       }
   ],
   "additionalDetails": [
       {
           "key": "User-Agent",
           "value": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/115.0"
       }
   ]
}