Compartilhar via

Admin - Groups DeleteUserAsAdmin

  • Referência
Service:
Power BI REST APIs
API Version:
v1.0

Remove permissões de usuário do workspace especificado.

Essa chamada à API dá suporte à remoção de um usuário, grupo de segurança, grupo M365 e entidade de serviço. Use o endereço de email ou UPN para usuário, ID de objeto de grupo para grupo e ID de objeto de aplicativo para a entidade de serviço excluir.

Permissões

O usuário deve ter direitos de administrador (como Office 365 Administrador Global ou Administrador de Serviços do Power BI).

Escopo necessário

Tenant.ReadWrite.All

Limitações

Máximo de 200 solicitações 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 URI

Nome Em Obrigatório Tipo Description
groupId
 path True

string

uuid

A ID do workspace.
user
 path True

string

O UPN (nome de entidade de usuário) da ID do objeto de usuário ou grupo da ID do objeto de grupo ou aplicativo da entidade de serviço a ser excluída.
isGroup
 query

boolean

Se um determinado usuário é um grupo ou não. Esse parâmetro é necessário quando o usuário deve excluir é group.
profileId
 query

string

uuid

A ID do perfil da entidade de serviço a ser excluída.

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

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