accessPackageAssignment: filterByCurrentUser

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

Важно!

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

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

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

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

Разрешения

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

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

HTTP-запрос

GET /identityGovernance/entitlementManagement/accessPackageAssignments/filterByCurrentUser(on='parameterValue')

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

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

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

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

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

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

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

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

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

Отклик

В случае успеха этот метод возвращает код ответа 200 OK и коллекцию accessPackageAssignment в тексте ответа.

Если набор результатов охватывает несколько страниц, Microsoft Graph возвращает эту страницу со @odata.nextLink свойством в ответе, содержащим URL-адрес следующей страницы результатов. Если это свойство присутствует, продолжайте выполнять дополнительные запросы с URL-адресом @odata.nextLink в каждом ответе, пока не будут возвращены все результаты. Дополнительные сведения см. в статье Подкачка данных Microsoft Graph в приложении.

Примеры

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

Запрос

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

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

Отклик

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

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

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

{
  "value": [
        {
            "@odata.type": "#microsoft.graph.accessPackageAssignment",
            "id": "5521fb4f-6a6c-410a-9191-461a65fd39d4",
            "catalogId": "34cfe9a8-88bc-4c82-b3d8-6b77d7035c33",
            "accessPackageId": "ca6992f8-e413-49a1-9619-c9819f4f73e0",
            "assignmentPolicyId": "7c6e6874-789e-4f11-b351-cc7b5883deef",
            "targetId": "2cb14f51-0108-41d8-89da-cd0e05e2c988",
            "assignmentStatus": "Delivered",
            "assignmentState": "Delivered",
            "isExtended": false,
            "expiredDateTime": null,
            "schedule": {
                "startDateTime": "2021-01-19T20:02:36.013Z",
                "recurrence": null,
                "expiration": {
                    "endDateTime": "2022-01-19T20:02:36.013Z",
                    "duration": null,
                    "type": "afterDateTime"
                }
            }
        }
  ]
}
  • Last updated on