Admin - Groups GetGroupUsersAsAdmin
Mengembalikan daftar pengguna yang memiliki akses ke ruang kerja yang ditentukan.
Izin
- Pengguna harus memiliki hak administrator (seperti Office 365 Administrator Global atau Administrator Layanan Power BI) atau mengautentikasi menggunakan perwakilan layanan.
- Izin yang didelegasikan didukung.
Saat berjalan di bawah autentikasi perwakilan layanan, aplikasi tidak boleh memiliki izin admin yang diperlukan untuk Power BI yang diatur di dalam portal Azure.
Cakupan yang Diperlukan
Tenant.Read.All atau Tenant.ReadWrite.All
Hanya relevan saat mengautentikasi melalui token akses admin standar yang didelegasikan. Tidak boleh ada ketika autentikasi melalui perwakilan layanan digunakan.
Batasan
Maksimum 200 permintaan per jam.
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID ruang kerja |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
Contoh
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Sample Response
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"groupUserAccessRight": "Admin",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
},
{
"displayName": "Adam Wood",
"emailAddress": "Adam@contoso.com",
"groupUserAccessRight": "Member",
"identifier": "Adam@contoso.com",
"graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
"principalType": "User"
},
{
"displayName": "ContosoTestApp",
"groupUserAccessRight": "Admin",
"identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"principalType": "App"
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Group |
Pengguna Power BI dengan akses ke ruang kerja |
Group |
Hak akses (tingkat izin) yang dimiliki pengguna di ruang kerja |
Group |
Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke 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 dalam grafik Microsoft. 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 |
GroupUsers
Pembungkus respons OData untuk daftar pengguna Power BI dengan akses ke ruang kerja
Nama | Jenis | Deskripsi |
---|---|---|
odata.context |
string |
|
value |
Daftar pengguna dengan akses ke 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 |