accessPackageAssignmentRequest: filterByCurrentUser

  • Статья

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

Важно!

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

В Microsoft Entra Управление правами получите список объектов accessPackageAssignmentRequest, отфильтрованных для вошедшего пользователя.

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

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

Разрешения

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

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

HTTP-запрос

Примечание.

/accessPackageAssignmentRequests Путь будет прекращен в ближайшее время. Используйте путь /assignmentRequests.

GET /identityGovernance/entitlementManagement/assignmentRequests/filterByCurrentUser(on='parameterValue')
GET /identityGovernance/entitlementManagement/accessPackageAssignmentRequests/filterByCurrentUser(on='parameterValue')

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

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

Параметр Тип Описание
on accessPackageAssignmentRequestFilterByCurrentUserOptions Список текущих параметров пользователя, которые можно использовать для фильтрации в списке запросов на назначение пакета доступа. Возможные значения: target, createdBy, approver.

  • target используется для получения объектов, accessPackageAssignmentRequest где вошедший пользователь является целевым объектом. Итоговый список включает все запросы назначения, текущие и просроченные, которые были запрошены вызывающим объектом или для вызывающей стороны, во всех каталогах и пакетах доступа.

  • createdBy используется для получения объектов, accessPackageAssignmentRequest созданных вошедшего пользователя. Итоговый список включает все запросы назначения, созданные вызывающим лицом для себя или от имени других пользователей, например в случае прямого назначения администратора, во всех каталогах и пакетах доступа.

  • approver используется для получения объектов, accessPackageAssignmentRequest в которых пользователь, выполнивший вход, является допустимым утверждающем в любом содержающемся accessPackageAssignment/accessPackageAssignmentPolicy/requestApprovalSettings/approvalStages объекте (primaryApprovers или escalationApprovers). Результирующий список включает запросы назначения в состоянии ожидания , во всех каталогах и пакетах доступа, которым требуется решение от вызывающего объекта. Результирующий список содержит запросы назначения в pending состоянии во всех каталогах и пакетах доступа, которым требуется решение от вызывающего объекта.

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

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

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

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

Отклик

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

Примеры

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

Запрос

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/filterByCurrentUser(on='target')

Отклик

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

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

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

{
    "value": [
        {
            "@odata.type": "#microsoft.graph.accessPackageAssignmentRequest",
            "createdDateTime": "2021-01-19T20:02:23.907Z",
            "completedDate": "2021-01-19T20:02:40.97Z",
            "id": "46c1410d-ef96-44c5-ae9c-a577d014fe0e",
            "requestType": "AdminAdd",
            "requestState": "Delivered",
            "requestStatus": "Fulfilled",
            "isValidationOnly": false,
            "expirationDateTime": null,
            "justification": null,
            "answers": [],
            "schedule": {
                "startDateTime": "2021-01-19T20:01:57.643Z",
                "recurrence": null,
                "expiration": {
                    "endDateTime": null,
                    "duration": null,
                    "type": "noExpiration"
                }
            }
        }
    ]
}