Udostępnij przez

Admin - Groups DeleteUserAsAdmin

Usługa:
Power BI REST APIs
Wersja interfejsu API:
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, identyfikator obiektu grupy dla grupy i identyfikatora obiektu aplikacji dla jednostki usługi do usunięcia.

Uprawnienia

Użytkownik musi być administratorem sieci szkieletowej.

Wymagany zakres

Tenant.ReadWrite.All

Ograniczenia

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

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
Z parametrami opcjonalnymi: 
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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200

Delete guest user example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200

Delete service principal example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200

Delete user example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200