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 |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID ruang kerja |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
groupUserAccessRight | True |
Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja |
|
identifier | True |
string |
Pengidentifikasi prinsipal |
principalType | True |
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 |
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 |
---|---|
Group |
Pengguna Power BI dengan akses ke ruang kerja |
Group |
Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja |
Principal |
Jenis utama |
Service |
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 |
Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja |
|
identifier |
string |
Pengidentifikasi prinsipal |
principalType |
Jenis utama |
|
profile |
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 |