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

appConsentRequest: filterByCurrentUser

  • Статья

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

Важно!

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

Получение коллекции объектов appConsentRequest , для которых текущий пользователь является рецензентом, а состояние userConsentRequest для доступа к указанному приложению — InProgress.

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

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

Разрешения

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

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

HTTP-запрос

GET /identityGovernance/appConsent/appConsentRequests/filterByCurrentUser(on='parameterValue')

Параметры функции

В URL-адресе запроса укажите перечисленные ниже параметры запроса и их значения. В приведенной ниже таблице указаны параметры, которые можно использовать с этой функцией.

Свойство Тип Описание
on consentRequestFilterByCurrentUserOptions Фильтр для запроса объектов appConsentRequest, для которых текущий пользователь является рецензентом. Допустимое значение — reviewer. Обязательно.

Параметры запроса

Эта функция требует , $filter чтобы параметр запроса OData (eq) возвращал коллекцию объектов userConsentRequest , состояние для которых равно InProgress. Функция также поддерживает $select параметр запроса. Общие сведения см. в статье Параметры запроса OData.

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

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

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

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

Отклик

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

Пример 1. Вывод списка всех appConsentRequests

Запрос

GET https://graph.microsoft.com/beta/identityGovernance/appConsent/appConsentRequests/filterByCurrentUser(on='reviewer')?$filter=userConsentRequests/any(u:u/status eq 'InProgress')

Отклик

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(appConsentRequest)",
    "@odata.count": 1,
    "value": [
        {
            "@odata.type": "#microsoft.graph.appConsentRequest",
            "id": "7322e5f3-0f15-4eb8-9e82-2029e8622f5d",
            "appId": "de8bc8b5-d9f9-48b1-a8ad-b748da725064",
            "appDisplayName": "Graph Explorer",
            "consentType": "Dynamic",
            "pendingScopes": [
                {
                    "displayName": "AccessReview.Read.All"
                },
                {
                    "displayName": "openid"
                },
                {
                    "displayName": "profile"
                },
                {
                    "displayName": "offline_access"
                }
            ],
            "userConsentRequests": []
        }
    ]
}