Admin - Groups AddUserAsAdmin

Service:

Power BI REST APIs

API Version:

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

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

Sample Response

Status code:

200

Add service principal to workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

Sample Response

Status code:

200

Add user to group example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

Status code:

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