Obtener approverDelegate

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Lea las propiedades del objeto approverDelegate configurado para un usuario. El delegado aprobador identifica el usuario o grupo que puede aprobar o denegar las solicitudes de asignación de paquetes de acceso y las revisiones de acceso de administración de derechos de Microsoft Entra en nombre del usuario, y el período durante el cual la delegación está en vigor.

Los usuarios que han iniciado sesión pueden leer su propio delegado de aprobador. Los administradores pueden leer el delegado de aprobador de cualquier usuario del inquilino.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. 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.

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 No admitida. No admitida.

Importante

Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. Esta operación admite los siguientes roles integrados, que proporcionan solo el privilegio mínimo necesario:

  • Lector global
  • Administrador de gobernanza de identidades

No se requiere ningún rol de directorio para leer su propio delegado de aprobador a través de la ruta de /me acceso.

Solicitud HTTP

Para leer el delegado de aprobador del usuario que ha iniciado sesión:

GET /me/identityGovernance/approverDelegate

Para leer el delegado de aprobador de otro usuario:

GET /users/{user-id}/identityGovernance/approverDelegate

Parámetros de consulta opcionales

Este método no admite ningún parámetro de consulta OData para ayudar a personalizar la respuesta.

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 un objeto approverDelegate en el cuerpo de la respuesta.

Si no se configura ningún delegado de aprobador para el usuario, este método devuelve un 200 OK código de respuesta en null el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Obtener el delegado de aprobador del usuario con la sesión iniciada

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/me/identityGovernance/approverDelegate

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

Ejemplo 2: Obtener el delegado aprobador de otro usuario

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/users/87ec4b08-df41-4e9c-8f0c-2e6c9e19b0d3/identityGovernance/approverDelegate

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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"
    }
  }
}
  • Se actualizó por última vez el