Share via

Admin - Groups DeleteUserAsAdmin

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

Menghapus izin pengguna dari ruang kerja yang ditentukan.

Panggilan API ini mendukung penghapusan pengguna, grup keamanan, grup M365, dan perwakilan layanan. Silakan gunakan alamat email atau UPN untuk pengguna, ID objek grup untuk id objek grup dan aplikasi untuk dihapus oleh perwakilan layanan.

Izin

Pengguna harus memiliki hak administrator (seperti Office 365 Administrator Global atau Administrator Layanan Power BI).

Cakupan yang Diperlukan

Tenant.ReadWrite.All

Batasan

Maksimum 200 permintaan per jam. 

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}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
groupId
 path True

string

uuid

ID ruang kerja.
user
 path True

string

Nama prinsipal pengguna (UPN) id objek pengguna atau grup id grup atau objek aplikasi dari perwakilan layanan yang akan dihapus.
isGroup
 query

boolean

Apakah pengguna tertentu adalah grup atau tidak. Parameter ini diperlukan saat pengguna untuk menghapus adalah grup.
profileId
 query

string

uuid

ID profil perwakilan layanan yang akan dihapus.

Respons

Nama Jenis Deskripsi
200 OK

OK

Contoh

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