Compartir a través de

Admin - Groups DeleteUserAsAdmin

  • Referencia
Service:
Power BI REST APIs
API Version:
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 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 tener derechos de administrador (como Office 365 administrador global o administrador del servicio Power BI).

Á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}
With optional parameters: 
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 grupo o usuario 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 el grupo.
profileId
 query

string

uuid

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

Respuestas

Nombre Tipo Description
200 OK

Aceptar

Ejemplos

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

Delete group example

Sample Request

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

Sample Response

Status code:
200

Delete guest user example

Sample Request

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

Sample Response

Status code:
200

Delete service principal example

Sample Request

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

Sample Response

Status code:
200

Delete user example

Sample Request

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

Sample Response

Status code:
200