Compartir a través de

Eliminar agenteUsuario

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.

Elimine un objeto agentUser .

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 Permiso con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) AgentIdUser.ReadWrite.IdentityParentedBy AgentIdUser.ReadWrite.All, User.DeleteRestore.All, User.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación AgentIdUser.ReadWrite.IdentityParentedBy AgentIdUser.ReadWrite.All, User.DeleteRestore.All, User.ReadWrite.All

Importante

Al usuario que realiza la llamada se le debe asignar al menos uno de los siguientes roles de Microsoft Entra:

  • Administrador de usuarios
  • Administrador de autenticación con privilegios
  • Administrador de id. de agente

Para eliminar usuarios con roles de administrador con privilegios en escenarios delegados, se debe asignar a la aplicación el permiso delegado Directory.AccessAsUser.All y el usuario que realiza la llamada debe tener un rol de administrador con privilegios más alto, como se indica en Quién puede realizar acciones confidenciales.

En escenarios de solo aplicación, el permiso de aplicación User.ReadWrite.All no es suficiente privilegio para eliminar usuarios con roles administrativos con privilegios. Al agente se le debe asignar un rol de administrador con privilegios superiores, como se indica en Quién puede realizar acciones confidenciales.

Solicitud HTTP

DELETE /users/microsoft.graph.agentUser/{userId}

Nota: También se puede eliminar un usuario del agente a través del punto de conexión de los usuarios estándar: DELETE /users/userId. No es necesario especificar ningún tipo de odata especial en la solicitud.

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 código de respuesta 204 No Content.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

DELETE https://graph.microsoft.com/beta/users/microsoft.graph.agentUser/ba9a3254-9f18-4209-aeb3-9e42a35b5be4

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content
  • Last updated on