Condividi tramite

Admin - Groups DeleteUserAsAdmin

  • Riferimento
Service:
Power BI REST APIs
API Version:
v1.0

Rimuove le autorizzazioni utente dall'area di lavoro specificata.

Questa chiamata API supporta la rimozione di un utente, un gruppo di sicurezza, un gruppo M365 e un'entità servizio. Usare l'indirizzo di posta elettronica o UPN per l'utente, l'ID oggetto gruppo per l'ID dell'oggetto gruppo e dell'app per l'eliminazione dell'entità servizio.

Autorizzazioni

L'utente deve avere diritti di amministratore, ad esempio Office 365 amministratore globale o amministratore del servizio Power BI.

Ambito obbligatorio

Tenant.ReadWrite.All

Limitazioni

Massimo 200 richieste all'ora. 

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}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
groupId
 path True

string

uuid

ID area di lavoro.
user
 path True

string

Nome dell'entità utente (UPN) dell'ID dell'oggetto utente o del gruppo del gruppo o dell'ID oggetto app dell'entità servizio da eliminare.
isGroup
 query

boolean

Se un determinato utente è un gruppo o meno. Questo parametro è necessario quando l'utente da eliminare è gruppo.
profileId
 query

string

uuid

ID del profilo dell'entità servizio da eliminare.

Risposte

Nome Tipo Descrizione
200 OK

OK

Esempio

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