accessPackageAssignment: filterByCurrentUser

  • Статья

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

Важно!

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

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

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

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

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) 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"
                }
            }
        }
  ]
}