Sdílet prostřednictvím

Admin - Groups DeleteUserAsAdmin

Služba:
Power BI REST APIs
Verze rozhraní API:
v1.0

Odebere uživatelská oprávnění z zadaného pracovního prostoru.

Toto volání rozhraní API podporuje odebrání uživatele, skupiny zabezpečení, skupiny M365 a instančního objektu. Pro uživatele, ID objektu skupiny a ID objektu aplikace pro odstranění instančního objektu použijte e-mailovou adresu nebo hlavní název uživatele( UPN).

Dovolení

Uživatel musí být správcem prostředků infrastruktury.

Požadovaný obor

Tenant.ReadWrite.All

Omezení

Maximálně 200 požadavků za hodinu. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
S volitelnými parametry: 
DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}?profileId={profileId}&isGroup={isGroup}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
groupId
 path True

string (uuid)

ID pracovního prostoru.
user
 path True

string

Hlavní název uživatele (UPN) id objektu uživatele nebo skupiny skupiny skupiny nebo ID objektu aplikace instančního objektu, který se má odstranit.
isGroup
 query

boolean

Bez ohledu na to, jestli je daný uživatel skupina, nebo ne. Tento parametr se vyžaduje, když je uživatel, který má odstranit skupinu.
profileId
 query

string (uuid)

ID profilu instančního objektu, které chcete odstranit.

Odpovědi

Name Typ Description
200 OK

OK

Příklady

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

Delete group example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200

Delete guest user example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200

Delete service principal example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200

Delete user example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200