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


Создание журналаDefinitions

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

Важно!

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

Создайте объект accessReviewHistoryDefinition .

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

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

Разрешения

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

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

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

Запись проверок доступа для группы или приложения Запись проверок доступа для роли Microsoft Entra
Администратор пользователей
Администратор управления удостоверениями
Администратор привилегированных ролей управления удостоверениями

HTTP-запрос

POST /identityGovernance/accessReviews/historyDefinitions

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

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

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

В тексте запроса укажите представление объекта accessReviewHistoryDefinition в формате JSON.

В следующей таблице показаны необходимые свойства, используемые для создания accessReviewHistoryDefinition.

Свойство Тип Описание
displayName String Имя для сбора данных журнала проверки доступа. Обязательно.
reviewHistoryPeriodStartDateTime DateTimeOffset Метка времени. Проверки, начиная с этой даты или после этой даты, находятся в извлекаемых данных журнала. Требуется только в том случае , если scheduleSettings не определен.
reviewHistoryPeriodEndDateTime DateTimeOffset Метка времени. Проверки, начиная с этой даты или раньше, включаются в данные извлекаемого журнала. Требуется только в том случае , если scheduleSettings не определен.
scopes коллекция accessReviewQueryScope Используется для фильтрации проверок, включенных в извлекаемые данные журнала. Извлекает проверки, область которой соответствует указанной области. Обязательно.
Дополнительные сведения см. в статье Поддерживаемые запросы области для accessReviewHistoryDefinition.
scheduleSettings accessReviewHistoryScheduleSettings Пока не поддерживается. Параметры для последовательности определений журнала проверки повторяющегося доступа. Требуется только в том случае, если reviewHistoryPeriodStartDateTime или reviewHistoryPeriodEndDateTime не определены.

Поддерживаемые запросы области для accessReviewHistoryDefinition

Параметр $filter запроса с оператором contains поддерживается в свойстве областиaccessReviewScheduleDefinition. Используйте следующий формат для запроса:

/identityGovernance/accessReviews/definitions?$filter=contains(scope/microsoft.graph.accessReviewQueryScope/query, '{object}')

Может {object} иметь одно из следующих значений:

Значение Описание
/groups Перечисление каждого accessReviewScheduleDefinition в отдельных группах (исключает определения, ограниченные всеми группами Microsoft 365 с гостями).
/groups/{group id} Перечисление каждого accessReviewScheduleDefinition в определенной группе (исключает определения, ограниченные всеми группами Microsoft 365 с гостями).
./members Перечисление каждого доступаReviewScheduleDefinition для всех групп Microsoft 365 с гостями.
accessPackageAssignments Вывод списка всех accessReviewScheduleDefinition в пакете доступа.
roleAssignmentScheduleInstances Список всех accessReviewScheduleDefinition для субъектов, которым назначена привилегированная роль.

Параметр $filter запроса не поддерживается в accessReviewInactiveUserQueryScope или principalResourceMembershipScope.

Отклик

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

Примеры

В следующем примере показано, как создать определение журнала проверки доступа с областью проверки доступа в пакетах и группах доступа, выполняемое между датой начала 01.2021 и датой окончания 05.04.2021.

Запрос

POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/historyDefinitions
Content-Type: application/json

{
  "displayName": "Last quarter's group reviews April 2021",
  "decisions": [
    "approve",
    "deny",
    "dontKnow",
    "notReviewed",
    "notNotified"
  ],
  "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
  "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
  "scopes": [
    {
      "@odata.type": "#microsoft.graph.accessReviewQueryScope",
      "queryType": "MicrosoftGraph",     
      "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, 'accessPackageAssignments')",
      "queryRoot": null
    },  
    {
      "@odata.type": "#microsoft.graph.accessReviewQueryScope",
      "queryType": "MicrosoftGraph",     
      "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '/groups')",
      "queryRoot": null
    }
  ]
}

Отклик

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

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
    "id": "b2cb022f-b7e1-40f3-9854-c65a40861c38",
    "displayName": "Last quarter's group reviews April 2021",
    "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
    "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
    "decisions": [
        "approve",
        "deny",
        "dontKnow",
        "notReviewed",
        "notNotified"
    ],
    "status": "requested",
    "createdDateTime": "2021-04-14T00:22:48.9392594Z",
    "createdBy": {
        "id": "957f1027-c0ee-460d-9269-b8444459e0fe",
        "displayName": "MOD Administrator",
        "userPrincipalName": "admin@contoso.com"
    },
    "scopes": [
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "queryType": "MicrosoftGraph",
            "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, 'accessPackageAssignments')",
            "queryRoot": null
        },
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "queryType": "MicrosoftGraph",
            "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, '/groups')",
            "queryRoot": null
        }
    ]
}