Bagikan melalui

Admin - Groups AddUserAsAdmin

Layanan:
Power BI REST APIs
Versi API:
v1.0

Memberikan izin pengguna ke ruang kerja yang ditentukan.

Panggilan API ini hanya mendukung penambahan pengguna, grup keamanan, grup M365, dan perwakilan layanan.

Permissions

Pengguna harus menjadi administrator Fabric.

Cakupan yang Diperlukan

Tenant.ReadWrite.All

Keterbatasan

  • Maksimum 200 permintaan per jam.
  • Setiap ruang kerja dibatasi hingga maksimum 1.000 pengguna atau grup dalam peran ruang kerja (Admin, Anggota, Kontributor, Penampil). Jumlah pengguna dalam grup tidak terbatas. Batasan ini juga mencakup tamu eksternal. 

POST https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
groupId
 path True

string (uuid)

ID ruang kerja

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
groupUserAccessRight True

GroupUserAccessRight

Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja
identifier True

string

Pengidentifikasi utama
principalType True

PrincipalType

Jenis utama
displayName

string

Nama tampilan prinsipal
emailAddress

string

Alamat email pengguna
graphId

string

Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin.
profile

ServicePrincipalProfile

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.
userType

string

Jenis pengguna.

Respons

Nama Jenis Deskripsi
200 OK

OK

Contoh

Add security group to workspace example
Add service principal to workspace example
Add user to group example

Add security group to workspace example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Isi Permintaan
{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

Respon sampel

Kode status:
200

Add service principal to workspace example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Isi Permintaan
{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

Respon sampel

Kode status:
200

Add user to group example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Isi Permintaan
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Respon sampel

Kode status:
200

Definisi

Nama Deskripsi
GroupUser

Pengguna Power BI dengan akses ke ruang kerja
GroupUserAccessRight

Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja
PrincipalType

Jenis utama
ServicePrincipalProfile

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

GroupUser

Objek

Pengguna Power BI dengan akses ke ruang kerja

Nama Jenis Deskripsi
displayName

string

Nama tampilan prinsipal
emailAddress

string

Alamat email pengguna
graphId

string

Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin.
groupUserAccessRight

GroupUserAccessRight

Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja
identifier

string

Pengidentifikasi utama
principalType

PrincipalType

Jenis utama
profile

ServicePrincipalProfile

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.
userType

string

Jenis pengguna.

GroupUserAccessRight

Enumeration

Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja

Nilai Deskripsi
None

Tidak ada akses ke konten ruang kerja
Member

Membaca, membentuk ulang, dan menjelajahi hak akses (ReadReshareExplore) ke konten ruang kerja
Admin

Hak administrator untuk konten ruang kerja
Contributor

Membaca dan menjelajahi akses (ReadExplore) ke konten ruang kerja
Viewer

Akses baca-saja (Baca) ke konten ruang kerja

PrincipalType

Enumeration

Jenis utama

Nilai Deskripsi
None

Tidak ada jenis utama. Gunakan untuk seluruh akses tingkat organisasi.
User

Jenis prinsipal pengguna
Group

Jenis prinsipal grup
App

Jenis perwakilan layanan

ServicePrincipalProfile

Objek

Profil perwakilan layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

Nama Jenis Deskripsi
displayName

string

Nama profil perwakilan layanan
id

string (uuid)

ID profil perwakilan layanan