accessPackageAssignment: reprocess
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.
En Microsoft Entra administración de derechos, los autores de llamadas pueden volver a evaluar y aplicar automáticamente un objeto accessPackageAssignment de las asignaciones de un usuario para un paquete de acceso específico. El valor assignmentState del paquete de acceso debe ser Delivered para que el administrador vuelva a procesar la asignación del usuario. Solo los administradores con el rol Administrador de asignaciones de paquetes de acceso, o superior, en Microsoft Entra administración de derechos pueden realizar esta acción.
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 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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.ReadWrite.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | EntitlementManagement.ReadWrite.All | No disponible. |
Sugerencia
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión también se le debe asignar un rol de administrador con permisos de rol admitidos mediante una de las siguientes opciones:
-
Un rol en el sistema de administración de derechos donde los roles con privilegios mínimos son:
- Administrador de asignaciones de paquetes de acceso. Esta es la opción con menos privilegios
- Administrador de paquetes de acceso
- Propietario del catálogo
- Roles de Microsoft Entra con más privilegios admitidos para esta operación:
- Administrador de gobernanza de identidades
En escenarios de solo aplicación, se puede asignar a la aplicación que realiza la llamada uno de los roles admitidos anteriores en lugar del permiso de EntitlementManagement.ReadWrite.All aplicación. El rol administrador de asignación de paquetes de Access tiene menos privilegios que el permiso de aplicación EntitlementManagement.ReadWrite.All .
Para obtener más información, vea Delegación y roles en la administración de derechos y cómo delegar la gobernanza del acceso a administradores de paquetes de acceso en la administración de derechos.
Solicitud HTTP
POST /identityGovernance/entitlementManagement/accessPackageAssignments/{id}/reprocess
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 202 Accepted código de respuesta y vuelve a evaluar y aplica las asignaciones del usuario del objeto accessPackageAssignment , lo que significa que el estado del paquete de acceso cambia a entregado. Si la asignación no existe, este método devuelve404 Not Found o si el identificador no es válido, este método devuelve un 400 Bad Request código de respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignments/d82eb508-acc4-43cc-bcf1-7c1c4a2c073b/reprocess
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted