命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
读取为用户配置的 approverDelegate 对象的属性。 审批者委托确定可以代表用户批准或拒绝 Microsoft Entra 权利管理访问包分配请求和访问评审的用户或组,以及委派生效的期限。
登录用户可以读取自己的审批者委托。 管理员可以读取租户中任何用户的审批者委托。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派(工作或学校帐户) | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
| 委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
| 应用程序 | 不支持。 | 不支持。 |
重要
对于使用工作或学校帐户的委派访问权限,必须为登录用户分配受支持的 Microsoft Entra 角色或授予此操作所需权限的自定义角色。 此操作支持以下内置角色,这些角色仅提供所需的最小权限:
- 全局读取者
- Identity Governance Administrator
不需要目录角色即可通过 /me 路径读取自己的审批者委托。
HTTP 请求
读取已登录用户的审批者委托:
GET /me/identityGovernance/approverDelegate
读取其他用户的审批者委托:
GET /users/{user-id}/identityGovernance/approverDelegate
可选的查询参数
此方法不支持任何 OData 查询参数 来帮助自定义响应。
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法将在响应正文中返回 200 OK 响应代码和 approverDelegate 对象。
如果未为用户配置审批者委托,则此方法将在响应正文中返回响应 200 OK 代码 null 。
示例
示例 1:获取已登录用户的审批者委托
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/me/identityGovernance/approverDelegate
响应
以下示例显示了相应的响应。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('87ec4b08-df41-4e9c-8f0c-2e6c9e19b0d3')/identityGovernance/approverDelegate",
"delegate": {
"@odata.type": "#microsoft.graph.singleUser",
"id": "d8f4bcd2-4d5a-4a1e-88a5-b0f1c98d2f27",
"description": "Alex Wilber"
},
"schedule": {
"startDateTime": "2026-08-31T08:21:41.338Z",
"expiration": {
"endDateTime": "2026-09-07T08:21:41.339Z",
"type": "afterDateTime"
}
}
}
示例 2:获取另一个用户的审批者委托
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/beta/users/87ec4b08-df41-4e9c-8f0c-2e6c9e19b0d3/identityGovernance/approverDelegate
响应
以下示例显示了相应的响应。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('87ec4b08-df41-4e9c-8f0c-2e6c9e19b0d3')/identityGovernance/approverDelegate",
"delegate": {
"@odata.type": "#microsoft.graph.groupMembers",
"id": "1c5f0b3e-8d4a-4e39-9f2b-6a7c1d3e5f80",
"description": "Contoso approvers"
},
"schedule": {
"startDateTime": "2026-08-31T08:21:41.338Z",
"expiration": {
"type": "noExpiration"
}
}
}