Compartir a través de

Admin - Groups DeleteUserAsAdmin

Servicio:
Power BI REST APIs
Versión de la API:
v1.0

Quita los permisos de usuario del área de trabajo especificada.

Esta llamada API admite la eliminación de un usuario, un grupo de seguridad, un grupo de M365 y una entidad de servicio. Use la dirección de correo electrónico o el UPN para el usuario, el identificador de objeto de grupo y el identificador de objeto de aplicación para que la entidad de servicio elimine.

Permisos

El usuario debe ser administrador de Fabric.

Ámbito requerido

Tenant.ReadWrite.All

Limitaciones

Máximo de 200 solicitudes por hora. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
Con parámetros opcionales: 
DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}?profileId={profileId}&isGroup={isGroup}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
groupId
 path True

string (uuid)

Identificador del área de trabajo.
user
 path True

string

El nombre principal de usuario (UPN) del identificador de objeto de usuario o grupo del grupo del grupo o del identificador de objeto de aplicación de la entidad de servicio que se va a eliminar.
isGroup
 query

boolean

Si un usuario determinado es un grupo o no. Este parámetro es necesario cuando el usuario que se va a eliminar es group.
profileId
 query

string (uuid)

Identificador de perfil de entidad de servicio que se va a eliminar.

Respuestas

Nombre Tipo Description
200 OK

De acuerdo

Ejemplos

Delete group example
Delete guest user example
Delete service principal example
Delete user example

Delete group example

Solicitud de ejemplo

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23?isGroup=True

Respuesta de muestra

status code:
200

Delete guest user example

Solicitud de ejemplo

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/john_contoso.com%23EXT%23@test.com

Respuesta de muestra

status code:
200

Delete service principal example

Solicitud de ejemplo

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23

Respuesta de muestra

status code:
200

Delete user example

Solicitud de ejemplo

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d69/users/john@contoso.com

Respuesta de muestra

status code:
200