审批:filterByCurrentUser

命名空间:microsoft.graph

Microsoft Entra权利管理中,返回访问包分配审批的集合。 返回的对象是那些在调用用户批准范围内的对象。

组的 PIM 中,返回 分配审批的集合。 返回的对象是那些在调用用户批准范围内的对象。

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

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

权限

要调用此 API,需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限

对于权利管理

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

对于组的 PIM

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

HTTP 请求

若要在权利管理中检索审批资源,请执行以下操作:

GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/filterByCurrentUser(on='approver')

若要检索组的 PIM 中的审批资源,请执行以下操作:

GET /identityGovernance/privilegedAccess/group/assignmentApprovals/filterByCurrentUser(on='approver')

函数参数

此方法支持 OData 查询参数,以便通过大型结果集进行分页。 若要了解一般信息,请参阅 OData 查询参数

参数 类型 说明
on approvalFilterByCurrentUserOptions 允许的值为 approver。 必需。

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法在响应正文中返回响应 200 OK 代码和 审批 对象的集合。

示例

示例 1:在权利管理中检索审批资源

请求

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/filterByCurrentUser(on='approver')

响应

注意:为了提高可读性,可能缩短了此处显示的响应对象。

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.approval",
      "id": "368f6786-6786-368f-8667-8f3686678f36"
    }
  ]
}

示例 2:检索组的 PIM 中的审批资源

请求

GET https://graph.microsoft.com/v1.0/identityGovernance/privilegedAccess/group/assignmentApprovals/filterByCurrentUser(on='approver')

响应

注意:为了提高可读性,可能缩短了此处显示的响应对象。

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.approval",
      "id": "46bc634a-0696-43c5-bc99-d568bc3c27f5",
      "stages": [
        {
          "id": "46bc634a-0696-43c5-bc99-d568bc3c27f5",
          "displayName": null,
          "reviewedDateTime": null,
          "reviewResult": "NotReviewed",
          "status": "Completed",
          "assignedToMe": true,
          "justification": "",
          "reviewedBy": null
        }
      ]
    }
  ]
}