Журнал перечисленияDefinitions

  • Статья

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

Получите объекты accessReviewHistoryDefinition , созданные за последние 30 дней, включая все вложенные свойства.

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

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

Разрешения

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

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

Если пользователь, выполнив вход, не является членом роли каталога global Администратор или ролью глобального читателя, будут возвращены только определения, созданные пользователем, выполнившего вход.

HTTP-запрос

GET /identityGovernance/accessReviews/historyDefinitions

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

Этот метод поддерживает $topпараметры запроса , $filter, $expandи $skip OData для настройки ответа. Общие сведения см. в статье Параметры запроса OData. Включение ?$expand=instances вернет объекты accessReviewHistoryDefinitions вместе со связанными с ними экземплярами.

Размер страницы по умолчанию для этого API составляет 100 объектов accessReviewHistoryDefinitions . Чтобы повысить эффективность и избежать превышения времени ожидания из-за больших результирующих наборов, примените разбиение на $skip страницы с помощью параметров запроса и $top . Дополнительные сведения см. в статье Разбивка данных Microsoft Graph по страницам в приложении

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

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

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

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

Отклик

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

Примеры

Запрос

GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/historyDefinitions

Отклик

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

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

{
    "@odata.count": 1,
    "value": [
        {
            "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
            "id": "67e3de15-d263-45a9-8f4f-71271b495db7",
            "displayName": "Last year's ELM assignment reviews - one time",
            "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
            "reviewHistoryPeriodEndDateTime": "2021-04-05T00:00:00Z",
            "decisions": [
                "approve",
                "deny",
                "dontKnow",
                "notReviewed",
                "notNotified"
            ],
            "status": "done",
            "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
                }
            ]
        }
    ]
}