Partilhar via

Admin - Groups DeleteUserAsAdmin

Serviço:
Power BI REST APIs
Versão da API:
v1.0

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

Essa chamada de 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 id de objeto de grupo e de usuário para id de objeto de grupo e aplicativo para a entidade de serviço excluir.

Permissões

O usuário deve ser um administrador do Fabric.

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}
Com parâmetros opcionais: 
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 da entidade de usuário) da ID de 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 a excluir é agrupado.
profileId
 query

string (uuid)

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

Respostas

Nome Tipo Description
200 OK

OKEY

Exemplos

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

Delete group example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200

Delete guest user example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200

Delete service principal example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200

Delete user example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200