Bagikan melalui

Admin - Groups AddUserAsAdmin

  • Referensi
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.

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. 

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 prinsipal
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 utama 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 utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded.

GroupUser

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 prinsipal
principalType

PrincipalType

Jenis utama
profile

ServicePrincipalProfile

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

string

Jenis pengguna.

GroupUserAccessRight

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

Nama Jenis Deskripsi
Admin

string

Hak administrator untuk konten ruang kerja
Contributor

string

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

string

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

string

Tidak ada akses ke konten ruang kerja
Viewer

string

Akses baca-saja (Baca) ke konten ruang kerja

PrincipalType

Jenis utama

Nama Jenis Deskripsi
App

string

Jenis perwakilan layanan
Group

string

Jenis utama grup
None

string

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

string

Jenis prinsipal pengguna

ServicePrincipalProfile

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

Nama Jenis Deskripsi
displayName

string

Nama profil perwakilan layanan
id

string

ID profil perwakilan layanan