Admin - Reports GetReportsAsAdmin
Mengembalikan daftar laporan 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 yang didelegasikan standar. Tidak boleh ada saat 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/reports
GET https://api.powerbi.com/v1.0/myorg/admin/reports?$filter={$filter}&$top={$top}&$skip={$skip}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
$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/reports
Sample Response
{
"value": [
{
"datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715",
"name": "SalesMarketing",
"webUrl": "https://app.powerbi.com//reports/5b218778-e7a5-4d73-8187-f10824047715",
"embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715",
"workspaceId": "278e22a3-2aee-4057-886d-c3225423bc10"
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Admin |
Laporan Power BI yang dikembalikan oleh API Admin. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI. |
Admin |
Pembungkus respons OData untuk kumpulan laporan Admin Power BI |
Principal |
Jenis utama |
Report |
Entri kanan akses pengguna Power BI untuk laporan |
Report |
Hak akses yang dimiliki pengguna untuk laporan (tingkat izin) |
Service |
Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded. |
Subscription |
Langganan email untuk item Power BI (seperti laporan atau dasbor) |
Subscription |
Pengguna langganan email Power BI |
AdminReport
Laporan Power BI yang dikembalikan oleh API Admin. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI.
Nama | Jenis | Deskripsi |
---|---|---|
appId |
string |
ID aplikasi, dikembalikan hanya jika laporan milik aplikasi |
createdBy |
string |
Pemilik laporan. Hanya tersedia untuk laporan yang dibuat setelah Juni 2019. |
createdDateTime |
string |
Tanggal dan waktu pembuatan laporan |
datasetId |
string |
ID himpunan data laporan |
description |
string |
Deskripsi laporan |
embedUrl |
string |
URL laporan yang disematkan |
id |
string |
ID laporan |
isOwnedByMe |
boolean |
Tentukan apakah laporan dibuat oleh pengguna saat ini. |
modifiedBy |
string |
Pengguna terakhir yang mengubah laporan |
modifiedDateTime |
string |
Tanggal dan waktu laporan terakhir diubah |
name |
string |
Nama laporan |
originalReportId |
string |
ID laporan aktual saat ruang kerja diterbitkan sebagai aplikasi. |
reportType |
enum:
|
Jenis laporan |
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 Dapatkan Langganan Laporan sebagai Admin panggilan API. |
|
users |
(Nilai kosong) Detail akses pengguna untuk laporan Power BI. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna pada laporan Power BI dengan menggunakan panggilan Get Report Users as Admin API, atau panggilan POSTWorkspaceInfo API dengan |
|
webUrl |
string |
URL web laporan |
workspaceId |
string |
ID ruang kerja (GUID) laporan. Properti ini hanya akan dikembalikan di GetReportsAsAdmin. |
AdminReports
Pembungkus respons OData untuk kumpulan laporan Admin Power BI
Nama | Jenis | Deskripsi |
---|---|---|
odata.context |
string |
Konteks OData |
value |
Kumpulan laporan |
PrincipalType
Jenis utama
Nama | Jenis | Deskripsi |
---|---|---|
App |
string |
Jenis perwakilan layanan |
Group |
string |
Jenis prinsipal grup |
None |
string |
Tidak ada jenis utama. Gunakan untuk akses tingkat seluruh organisasi. |
User |
string |
Jenis prinsipal pengguna |
ReportUser
Entri kanan akses pengguna Power BI untuk laporan
Nama | Jenis | Deskripsi |
---|---|---|
displayName |
string |
Nama tampilan utama |
emailAddress |
string |
Alamat email pengguna |
graphId |
string |
Pengidentifikasi utama di Microsoft Graph. Hanya tersedia untuk API admin. |
identifier |
string |
Pengidentifikasi utama |
principalType |
Jenis utama |
|
profile |
Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded. |
|
reportUserAccessRight |
Hak akses yang dimiliki pengguna untuk laporan (tingkat izin) |
|
userType |
string |
Jenis pengguna. |
ReportUserAccessRight
Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)
Nama | Jenis | Deskripsi |
---|---|---|
None |
string |
Tidak ada izin untuk konten dalam laporan |
Owner |
string |
Memberikan akses Baca, Tulis, dan Buat Ulang ke konten dalam laporan |
Read |
string |
Memberikan akses Baca ke konten dalam laporan |
ReadCopy |
string |
Memberikan akses Baca dan Salin ke konten dalam laporan |
ReadReshare |
string |
Memberikan akses Baca dan Buat Ulang ke konten dalam laporan |
ReadWrite |
string |
Memberikan akses Baca dan Tulis ke konten dalam laporan |
ServicePrincipalProfile
Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan 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 merupakan 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 bisa 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 utama |
emailAddress |
string |
Alamat email pengguna |
graphId |
string |
Pengidentifikasi utama di Microsoft Graph. Hanya tersedia untuk API admin. |
identifier |
string |
Pengidentifikasi utama |
principalType |
Jenis utama |
|
profile |
Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded. |
|
userType |
string |
Jenis pengguna. |