获取 accessPackageAssignmentRequest
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
在Microsoft Entra权利管理中,检索 accessPackageAssignmentRequest 对象的属性和关系。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
提示
在具有工作或学校帐户的委托方案中,还必须通过以下选项之一为已登录用户分配具有支持的角色权限的管理员角色:
-
权利管理系统中具有最低特权角色的角色:
- 目录读取器。 这是最低特权选项
- 目录创建者
- 访问包管理器
- 此操作支持的更多特权Microsoft Entra角色:
- 安全信息读取者
- 全局读取者
- 合规性管理员
- 安全管理员
- 标识治理管理员
在仅限应用的情况下,可为调用应用分配上述受支持的角色之一,而不是 EntitlementManagement.Read.All
应用程序权限。
目录读取者角色的特权低于EntitlementManagement.Read.All
应用程序权限。
有关详细信息,请参阅 权利管理中的委派和角色 以及如何 在权利管理中将访问管理委托给访问包管理员。
HTTP 请求
注意
该 /accessPackageAssignmentRequests
路径即将停用。 请改用 /assignmentRequests
路径。
GET /identityGovernance/entitlementManagement/assignmentRequests/{accessPackageAssignmentRequestId}
GET /identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}
可选的查询参数
此方法支持 $expand
OData 查询参数来扩展关系,以检索 accessPackage
、 requestor
和 acccessPackageAssignment
。 例如,若要检索访问包分配的目标,请在 $expand=accessPackageAssignment($expand=target)
查询中包含 。 若要了解一般信息,请参阅 OData 查询参数。
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法在响应正文中返回响应 200 OK
代码和请求的 accessPackageAssignmentRequest 对象。
示例
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "c0cfd117-f90e-4f48-8226-e282a2ae752c",
"requestType": "UserAdd",
"requestState": "delivered",
"requestStatus": "Delivered",
"createdDateTime": "2022-01-07T00:51:12.817Z",
"completedDate": "2022-01-07T00:53:15.127Z",
"schedule": {
"startDateTime": null,
"recurrence": null,
"expiration": {
"endDateTime": null,
"duration": null,
"type": "notSpecified"
}
},
"customExtensionCalloutInstances": [
{
"status": "callbackReceived",
"externalCorrelationId": "08585600902100964604743022906CU13",
"customExtensionId": "e59ef33d-7bc4-4b15-8d3c-01153de8a498",
"id": "3C49CE50-E02C-4254-81E6-834328DF72DC",
"detail": "Request has been allowed"
}
]
}