Udostępnij za pośrednictwem

Admin - Groups DeleteUserAsAdmin

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Usuwa uprawnienia użytkownika z określonego obszaru roboczego.

To wywołanie interfejsu API obsługuje usuwanie użytkownika, grupy zabezpieczeń, grupy M365 i jednostki usługi. Użyj adresu e-mail lub nazwy UPN dla użytkownika, identyfikatora obiektu grupy dla grupy i identyfikatora obiektu aplikacji dla jednostki usługi do usunięcia.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI).

Zakres wymagany

Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200. 

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 identyfikatora URI

Nazwa W Wymagane Typ Opis
groupId
 path True

string

uuid

Identyfikator obszaru roboczego.
user
 path True

string

Główna nazwa użytkownika (UPN) identyfikatora obiektu użytkownika lub grupy grupy identyfikatora obiektu grupy lub aplikacji jednostki usługi do usunięcia.
isGroup
 query

boolean

Czy dany użytkownik jest grupą, czy nie. Ten parametr jest wymagany, gdy użytkownik do usunięcia jest grupą.
profileId
 query

string

uuid

Identyfikator profilu jednostki usługi do usunięcia.

Odpowiedzi

Nazwa Typ Opis
200 OK

OK

Przykłady

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