accessPackageAssignment: additionalAccess

Пространство имен: 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
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Не поддерживается. Не поддерживается.

Совет

Для делегированного доступа с помощью рабочих или учебных учетных записей вошедшему пользователю должна быть назначена роль администратора с поддерживаемыми ролевыми разрешениями одним из следующих способов:

  • Роль в системе управления правами, для которой наименее привилегированными ролями:
    • Средство чтения каталогов. Это наименее привилегированный вариант
    • Создатель каталогов
    • Доступ к диспетчеру пакетов
  • Более привилегированные роли Microsoft Entra, поддерживаемые для этой операции:
    • Читатель сведений о безопасности
    • Глобальный читатель
    • Администратор соответствия требованиям
    • Администратор безопасности
    • Администратор управления удостоверениями

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

Дополнительные сведения см. в статьях Делегирование и роли в управлении правами , а также Управление делегированием доступа для доступа к диспетчерам пакетов в управлении правами.

HTTP-запрос

GET /identityGovernance/entitlementManagement/accessPackageAssignments/additionalAccess(accessPackageId='parameterValue',incompatibleAccessPackageId='parameterValue')

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

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

Параметр Тип Описание
accessPackageId String Указывает идентификатор пакета доступа, для которого вызывающая сторона хочет получить назначения. Обязательно.
incompatibleAccessPackageId String Определенный несовместимый пакет доступа, для которого вызывающая сторона хочет получить только те назначения, для которых у пользователя также есть назначение этому несовместимому пакету доступа. Обязательно.

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

Этот метод поддерживает параметры запросов $select, $filterи $expand OData, помогающие настраивать ответ. Общие сведения см. в статье Параметры запроса OData.

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

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

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

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

Отклик

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

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

Примеры

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

Запрос

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

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignments/additionalAccess(accessPackageId='2506aef1-3929-4d24-a61e-7c8b83d95e6f',incompatibleAccessPackageId='d5d99728-8c0b-4ede-83d2-cf9b0e8dabfb')?$expand=target

Отклик

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

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

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

{
  "value": [
        {
            "@odata.type": "#microsoft.graph.accessPackageAssignment",
            "id": "a61f7889-ae61-4e97-a4dc-e4fa525f5b33",
            "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
            "accessPackageId": "2506aef1-3929-4d24-a61e-7c8b83d95e6f",
            "assignmentPolicyId": "07c7c99d-6cf3-4527-bd05-5fc2ac8e96e7",
            "targetId": "cdbdf152-82ce-479c-b5b8-df90f561d5c7",
            "target": {
                "id": "ebaf071e-c647-42c6-b86f-fbe3625b4b63",
                "objectId": "cdbdf152-82ce-479c-b5b8-df90f561d5c7",
                "displayName": "user1"
            }
        },
        {
            "@odata.type": "#microsoft.graph.accessPackageAssignment",
            "id": "a7284263-8233-44de-8095-0ee3ff5a1716",
            "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
            "accessPackageId": "2506aef1-3929-4d24-a61e-7c8b83d95e6f",
            "assignmentPolicyId": "07c7c99d-6cf3-4527-bd05-5fc2ac8e96e7",
            "targetId": "79a8f0b6-61dc-41db-b49e-470c278e05b6",
            "target": {
                "id": "9865b0f8-868f-42c6-a49b-3067eb4b2da1",
                "objectId": "79a8f0b6-61dc-41db-b49e-470c278e05b6",
                "displayName": "user2"
            }
        }
  ]
}
  • Last updated on