Sdílet prostřednictvím

Admin - Groups DeleteUserAsAdmin

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

Odebere uživatelská oprávnění ze 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. Použijte e-mailovou adresu nebo hlavní název uživatele (UPN) pro uživatele, ID objektu skupiny pro skupinu a ID objektu aplikace k odstranění instančního objektu.

Oprávnění

Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI).

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}
With optional parameters: 
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 ID skupiny nebo objektu aplikace instančního objektu, který se má odstranit.
isGroup
 query

boolean

Určuje, jestli je daný uživatel skupinou, nebo ne. Tento parametr se vyžaduje, pokud je uživatel, který se má odstranit, skupina.
profileId
 query

string

uuid

ID profilu instančního objektu, který se má 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

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