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

Список customSecurityAttributeAudits

  • Статья

Пространство имен: 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

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

Этот метод поддерживает $filter параметры запроса OData (eq, ge, le, startswith), $top, $orderbyи skiptoken , чтобы помочь настроить ответ. Размер страницы по умолчанию и максимальный для $top — 100 объектов. Общие сведения см. в статье Параметры запроса OData.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/auditLogs/customSecurityAttributeAudits?$top=1

Отклик

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

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

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

[
    {
        "id": "testid",
        "category": "AttributeManagement",
        "correlationId": "79896ecf-ed75-4cee-8769-a51b639264ca",
        "result": "success",
        "resultReason": "",
        "activityDisplayName": "Add custom security attribute definition in an attribute set",
        "activityDateTime": "2024-01-07T19:02:30.433478Z",
        "loggedByService": "Core Directory",
        "operationType": "Add",
        "userAgent": null,
        "initiatedBy": {
            "app": null,
            "user": {
                "id": "dcb1b5f4-0829-4252-9f45-810ac1c2f91b",
                "displayName": null,
                "userPrincipalName": "admin1@contoso.com",
                "ipAddress": "{ipAddress}",
                "homeTenantId": null,
                "homeTenantName": null
            }
        },
        "targetResources": [
            {
                "id": "934760c7-fba0-4ba6-8438-3d1e40eb8d01",
                "displayName": null,
                "type": "Other",
                "userPrincipalName": null,
                "groupType": null,
                "modifiedProperties": [
                    {
                        "displayName": "Included Updated Properties",
                        "oldValue": null,
                        "newValue": "\"\""
                    },
                    {
                        "displayName": "TargetId.UserType",
                        "oldValue": null,
                        "newValue": "\"Member\""
                    }
                ]
            }
        ],
        "additionalDetails": [
            {
                "key": "User-Agent",
                "value": "{value}"
            }
        ]
    }
]