approval: filterByCurrentUser

Espacio de nombres: microsoft.graph

En Microsoft Entra administración de derechos, devuelva una colección de aprobaciones de asignación de paquetes de acceso. Los objetos devueltos son aquellos que están en el ámbito para su aprobación por el usuario que realiza la llamada.

En PIM para grupos, devuelva una colección de aprobaciones de asignación. Los objetos devueltos son aquellos que están en el ámbito para su aprobación por el usuario que realiza la llamada.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Para la administración de derechos

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) EntitlementManagement.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación No admitida.

Para PIM para grupos

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) PrivilegedAssignmentSchedule.Read.AzureADGroup, PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación No admitida.

Solicitud HTTP

Para recuperar los recursos de aprobación en la administración de derechos:

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

Para recuperar los recursos de aprobación en PIM para grupos:

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

Parámetros de función

Este método admite los parámetros de consulta de OData para paginar a través de un conjunto de resultados grande. Para obtener información general, vea Parámetros de consulta OData.

Parámetro Tipo Descripción
on approvalFilterByCurrentUserOptions El valor permitido es approver. Necesario.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos de aprobación en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Recuperación de los recursos de aprobación en la administración de derechos

Solicitud

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

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

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

Ejemplo 2: Recuperación de los recursos de aprobación en PIM para grupos

Solicitud

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

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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
        }
      ]
    }
  ]
}