Bagikan melalui


Groups - Add Group User

Memberi pengguna yang ditentukan izin yang ditentukan ke ruang kerja yang ditentukan.

Izin

Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Workspace.ReadWrite.All

Batasan

  • Izin pengguna untuk ruang kerja membutuhkan waktu untuk diperbarui dan mungkin tidak segera tersedia saat menggunakan panggilan API. Untuk merefresh izin pengguna, gunakan panggilan REFRESH USER Permissions API.

POST https://api.powerbi.com/v1.0/myorg/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

Assign administrator user access rights to a service principal example
Example

Assign administrator user access rights to a service principal example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Sample Response

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

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