Bagikan melalui

Admin - Groups DeleteUserAsAdmin

Layanan:
Power BI REST APIs
Versi API:
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 perwakilan layanan yang akan dihapus.

Permissions

Pengguna harus menjadi administrator Fabric.

Cakupan yang Diperlukan

Tenant.ReadWrite.All

Keterbatasan

Maksimum 200 permintaan per jam. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
Dengan parameter opsional: 
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 ruangkerja.
user
 path True

string

Nama prinsipal pengguna (UPN) id objek pengguna atau grup dari id objek grup atau 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

Permintaan sampel

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

Respon sampel

Kode status:
200

Delete guest user example

Permintaan sampel

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

Respon sampel

Kode status:
200

Delete service principal example

Permintaan sampel

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

Respon sampel

Kode status:
200

Delete user example

Permintaan sampel

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

Respon sampel

Kode status:
200