Admin - Dashboards GetDashboardsAsAdmin
Mengembalikan daftar dasbor untuk organisasi.
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 50 permintaan per jam atau 5 permintaan per menit, per penyewa.
GET https://api.powerbi.com/v1.0/myorg/admin/dashboards
GET https://api.powerbi.com/v1.0/myorg/admin/dashboards?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
$expand
|
query |
string |
Menerima daftar jenis data yang dipisahkan koma, yang akan diperluas sebaris dalam respons. |
|
$filter
|
query |
string |
Memfilter hasil, berdasarkan kondisi boolean |
|
$skip
|
query |
integer int32 |
Melompati hasil n pertama |
|
$top
|
query |
integer int32 |
Mengembalikan hanya hasil n pertama |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
Contoh
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/dashboards
Sample Response
{
"value": [
{
"id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
"displayName": "SalesMarketing",
"embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
"isReadOnly": false,
"workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Admin |
Dasbor Power BI yang dikembalikan oleh API Admin. API mengembalikan subset dari daftar properti dasbor berikut. Subset bergantung pada API yang disebut, izin penelepon, dan ketersediaan data dalam database Power BI. |
Admin |
Pembungkus respons OData untuk koleksi dasbor Power BI |
Admin |
Petak Peta Power BI yang dikembalikan oleh API Admin. |
Dashboard |
Entri kanan akses pengguna Power BI untuk dasbor |
Dashboard |
Hak akses yang dimiliki pengguna untuk dasbor (tingkat izin) |
Principal |
Jenis utama |
Service |
Profil utama layanan Power BI. Hanya relevan untuk solusi multipenyewa Power BI Embedded. |
Subscription |
Langganan email untuk item Power BI (seperti laporan atau dasbor) |
Subscription |
Pengguna langganan email Power BI |
AdminDashboard
Dasbor Power BI yang dikembalikan oleh API Admin. API mengembalikan subset dari daftar properti dasbor berikut. Subset bergantung pada API yang disebut, izin penelepon, dan ketersediaan data dalam database Power BI.
Nama | Jenis | Deskripsi |
---|---|---|
appId |
string |
ID aplikasi, dikembalikan hanya jika dasbor milik aplikasi |
displayName |
string |
Nama tampilan dasbor |
embedUrl |
string |
URL semat dasbor |
id |
string |
ID dasbor |
isReadOnly |
boolean |
Apakah dasbor bersifat baca-saja |
subscriptions |
(Nilai Kosong) Detail langganan untuk item Power BI (seperti laporan atau dasbor). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda bisa mengambil informasi langganan untuk laporan Power BI dengan menggunakan Langganan Dapatkan Laporan sebagai panggilan API Admin. |
|
tiles |
Petak peta yang termasuk dalam dasbor |
|
users |
(Nilai kosong) Detail akses pengguna dasbor. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna di dasbor Power BI dengan menggunakan Get Dashboard Users sebagai Admin panggilan API, atau panggilan POSTWorkspaceInfo API dengan |
|
webUrl |
string |
URL web dasbor |
workspaceId |
string |
ID ruang kerja (GUID) dasbor. Properti ini hanya akan dikembalikan di GetDashboardsAsAdmin. |
AdminDashboards
Pembungkus respons OData untuk koleksi dasbor Power BI
Nama | Jenis | Deskripsi |
---|---|---|
odata.context |
string |
Konteks OData |
value |
Koleksi dasbor |
AdminTile
Petak Peta Power BI yang dikembalikan oleh API Admin.
Nama | Jenis | Deskripsi |
---|---|---|
colSpan |
integer |
Jumlah kolom rentang petak peta |
datasetId |
string |
ID himpunan data. Hanya tersedia untuk petak peta yang dibuat dari laporan atau dengan menggunakan himpunan data, seperti petak peta Q&A. |
embedData |
string |
Menyematkan data untuk petak peta |
embedUrl |
string |
URL semat petak peta |
id |
string |
ID petak peta |
reportId |
string |
ID laporan. Hanya tersedia untuk petak peta yang dibuat dari laporan. |
rowSpan |
integer |
Jumlah baris rentang petak peta |
title |
string |
Nama tampilan petak peta |
DashboardUser
Entri kanan akses pengguna Power BI untuk dasbor
Nama | Jenis | Deskripsi |
---|---|---|
dashboardUserAccessRight |
Hak akses yang dimiliki pengguna untuk dasbor (tingkat izin) |
|
displayName |
string |
Nama tampilan prinsipal |
emailAddress |
string |
Alamat email pengguna |
graphId |
string |
Pengidentifikasi prinsipal di Microsoft Graph. Hanya tersedia untuk API admin. |
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. |
DashboardUserAccessRight
Hak akses yang dimiliki pengguna untuk dasbor (tingkat izin)
Nama | Jenis | Deskripsi |
---|---|---|
None |
string |
Tidak ada izin untuk konten di dasbor |
Owner |
string |
Memberikan akses Baca, Tulis, dan Reshare ke konten dalam laporan |
Read |
string |
Memberikan akses Baca ke konten di dasbor |
ReadCopy |
string |
Memberikan akses Baca dan Salin ke konten di dasbor |
ReadReshare |
string |
Memberikan akses Baca dan Reshare ke konten di dasbor |
ReadWrite |
string |
Memberikan akses Baca dan Tulis ke konten di dasbor |
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 |
Subscription
Langganan email untuk item Power BI (seperti laporan atau dasbor)
Nama | Jenis | Deskripsi |
---|---|---|
artifactDisplayName |
string |
Nama item Power BI langganan (seperti laporan atau dasbor) |
artifactId |
string |
ID item Power BI langganan (seperti laporan atau dasbor) |
artifactType |
string |
Jenis item Power BI (misalnya |
attachmentFormat |
string |
Format laporan yang dilampirkan dalam langganan email |
endDate |
string |
Tanggal dan waktu akhir langganan email |
frequency |
string |
Frekuensi langganan email |
id |
string |
ID langganan |
isEnabled |
boolean |
Apakah langganan email diaktifkan |
linkToContent |
boolean |
Apakah tautan langganan ada di langganan email |
previewImage |
boolean |
Apakah cuplikan layar laporan ada di langganan email |
startDate |
string |
Tanggal dan waktu mulai langganan email |
subArtifactDisplayName |
string |
Nama halaman item Power BI langganan, jika itu adalah laporan. |
title |
string |
Nama aplikasi |
users |
Detail setiap pelanggan email. Saat menggunakan panggilan Get User Subscriptions As Admin API, nilai yang dikembalikan adalah array kosong (null). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi langganan pada laporan atau dasbor Power BI dengan menggunakan panggilan Dapatkan Langganan Laporan Sebagai Admin atau Dapatkan Langganan Dasbor Sebagai Admin API. |
SubscriptionUser
Pengguna langganan email Power BI
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. |
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. |