Obtener aprobación

Espacio de nombres: microsoft.graph

Recuperar las propiedades de un objeto de aprobación . Esta solicitud de API la realiza un aprobador en los siguientes escenarios:

En la administración de derechos de Microsoft Entra, proporcionar el identificador de la solicitud de asignación del paquete de acceso. En PIM para Grupos, proporcionando el identificador de la solicitud de programación de asignación.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

En las tablas siguientes se muestran los permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga las prácticas recomendadas para solicitar permisos con privilegios mínimos. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Para la administración de derechos

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) EntitlementManagement.Read.All EntitlementManagement.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación EntitlementManagement.Read.All EntitlementManagement.ReadWrite.All

Sugerencia

Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol de administrador con permisos de rol admitidos a través de una de las siguientes opciones:

En escenarios de solo aplicación, a la aplicación que realiza la llamada se le puede asignar uno de los roles admitidos anteriores en lugar del permiso de la EntitlementManagement.Read.All aplicación. El rol de lector de catálogo tiene menos privilegios que el permiso de EntitlementManagement.Read.All aplicación.

Para obtener más información, consulte Delegación y roles en la administración de derechos y cómo delegar la gobernanza de acceso a los administradores de paquetes de acceso en la administración de derechos.

Para PIM para grupos

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) PrivilegedAssignmentSchedule.Read.AzureADGroup PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

Para obtener objetos de aprobación en la administración de derechos:

GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{accessPackageAssignmentRequestId}

Para obtener objetos de aprobación en PIM para grupos:

GET /identityGovernance/privilegedAccess/group/assignmentApprovals/{privilegedaccessgroupassignmentschedulerequestId}

Encabezados de solicitud

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

Cuerpo de la solicitud

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

Respuesta

Si se realiza correctamente, este método devuelve un 200 OK código de respuesta y el objeto de aprobación solicitado en el cuerpo de la respuesta. Si el autor de la llamada no tiene los permisos adecuados, el método devuelve un 403 Forbidden código de respuesta.

Ejemplos

Solicitud

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/abd306ef-f7b2-4a10-9fd1-493454322489

Respuesta

En el ejemplo siguiente se muestra la 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

{
    "id": "abd306ef-f7b2-4a10-9fd1-493454322489",
    "stages": [
        {
            "id": "d4fa4045-4716-436d-aec5-57b0a713f095",
            "displayName": null,
            "reviewedDateTime": null,
            "reviewResult": "NotReviewed",
            "status": "InProgress",
            "assignedToMe": true,
            "justification": "",
            "reviewedBy": null
        }
    ]
}