accessPackageAssignment: additionalAccess

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

在 Microsoft Entra 权利管理中,检索 accessPackageAssignment 对象的集合,这些对象指示目标用户分配了指定的访问包,并且还分配了另一个可能不兼容的访问包。 它可用于准备为特定的访问包配置不兼容的访问包。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) EntitlementManagement.Read.All EntitlementManagement.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 不支持。 不支持。

提示

对于使用工作或学校帐户的委派访问权限,必须通过以下选项之一为登录用户分配具有受支持角色权限的管理员角色:

  • 权利管理系统中的角色,其中最小特权角色为:
    • 目录读取者。 这是特权最低的选项
    • 目录创建者
    • 访问包管理器
  • 此操作支持的更多特权 Microsoft Entra 角色:
    • 安全信息读取者
    • 全局读取者
    • 合规性管理员
    • 安全管理员
    • Identity Governance Administrator

在仅限应用的情况下,可为调用应用分配上述支持的角色之一,而不是 EntitlementManagement.Read.All 应用程序权限。 目录读取者角色的特权低于EntitlementManagement.Read.All应用程序权限。

有关详细信息,请参阅 权利管理中的委派和角色以及如何 将 访问治理委托给权利管理中的访问包管理员。

HTTP 请求

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

函数参数

下表显示了必须通过此函数提供的参数。 这两个访问包 ID 必须不同。

参数 类型 说明
accessPackageId String 指示调用方想要检索其分配的访问包的 ID。 必填。
incompatibleAccessPackageId String 特定的不兼容访问包,调用方希望仅检索用户对此不兼容访问包有分配的分配。 必填。

可选的查询参数

此方法支持 $select、 和 $filter$expand OData 查询参数,以帮助自定义响应。 若要了解一般信息,请参阅 OData 查询参数。

请求标头

名称 说明
Authorization 持有者 {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"
            }
        }
  ]
}