Menggunakan REST API Power BI
REST API Power BI menyediakan titik akhir layanan untuk penyematan, administrasi, tata kelola, dan sumber daya pengguna.
Dengan REST API Power BI, Anda bisa melakukan hal berikut:
Mengelola konten Power BI
Melakukan operasi admin
Sematkan Konten Power BI
Catatan
Beberapa API Power BI merujuk ke ruang kerja sebagai grup. Referensi apa pun ke grup berarti Anda bekerja dengan ruang kerja.
Saat mengakses Power BI REST API, konten dan data permintaan dan respons Anda dapat diproses oleh pusat data di wilayah selain wilayah asal penyewa Power BI Anda.
Cakupan
Untuk menggunakan REST API Power BI, Anda perlu mendaftarkan aplikasi Azure Active Directory (Azure AD) di Azure. Aplikasi Azure AD menetapkan izin untuk Power BI sumber daya REST, dan memungkinkan akses ke REST API Power BI. Untuk mempelajari cara mendaftarkan aplikasi, lihat Mendaftarkan aplikasi Azure AD untuk digunakan dengan Power BI.
Setelah mendaftarkan aplikasi Azure AD, Anda dapat mengautentikasi terhadapnya menggunakan Azure AD (v1.0; ADAL) atau platform identitas Microsoft (v2.0; Titik akhir MSAL). Untuk mempelajari selengkapnya tentang cara kerja metode autentikasi ini, lihat Mengapa pembaruan ke platform identitas Microsoft (v2.0)?
Untuk informasi selengkapnya tentang izin akses Power BI, lihat Izin dan persetujuan di titik akhir platform identitas Microsoft.
Menggunakan perwakilan layanan
Cakupan tidak diperlukan jika Anda menggunakan perwakilan layanan. Setelah Anda mengaktifkan perwakilan layanan untuk digunakan dengan Power BI, izin AD aplikasi tidak berlaku lagi. Saat menggunakan perwakilan layanan, izin aplikasi dikelola melalui portal admin Power BI. Untuk informasi selengkapnya lihat Mengaktifkan pengaturan admin layanan Power BI.
Menambahkan cakupan
Untuk menambahkan izin ke aplikasi Azure AD Anda, ikuti langkah-langkah berikut:
Buka Aplikasi Anda di Azure.
Dari sebelah kiri, di bawah Kelola, pilih Izin API.
Pilih Tambahkan izin.
Di jendela Minta izin API , pilih Layanan Power BI.
Pilih izin yang didelegasikan. Daftar API ditampilkan.
Perluas API yang ingin Anda tambahkan izinnya, dan pilih izin yang ingin Anda tambahkan ke api tersebut.
Pilih Tambahkan izin.
Menghapus cakupan
Untuk menghapus izin dari aplikasi Azure AD Anda, ikuti langkah-langkah berikut:
Buka Aplikasi Anda di Azure.
Dari sebelah kiri, di bawah Kelola, pilih Izin API.
Pilih menu Konteks (elipsis izin).
Pilih Hapus izin.
Pembatasan
Power BI menggunakan pembatasan untuk mempertahankan performa dan keandalan yang optimal. Untuk mencegah penggunaan sumber daya yang berlebihan dari satu pengguna, Power BI membatasi jumlah panggilan API dalam jendela waktu per pengguna.
Saat pengguna mengirim sejumlah permintaan yang melebihi batas yang telah ditentukan selama jendela waktu, Power BI membatasi permintaan lebih lanjut dari pengguna tersebut untuk waktu yang singkat.
Saat aplikasi mengalami pembatasan, Power BI mengembalikan kode status HTTP 429 (Terlalu banyak permintaan) dengan header HTTP Retry-After dalam respons, menunjukkan berapa detik aplikasi panggilan harus menunggu sebelum membuat permintaan baru.
Grup Operasi REST
Tabel ini mencantumkan grup operasi Power BI REST API.
Catatan
Untuk mengelola kapasitas Power BI Embedded, gunakan REST API Power BI Embedded Azure Resource Manager.
| Grup operasi | Deskripsi |
|---|---|
| Admin | Operasi untuk bekerja dengan tugas administratif. |
| Aplikasi | Operasi untuk bekerja dengan Aplikasi. |
| Fitur yang Tersedia | Operasi yang mengembalikan fitur yang tersedia. |
| Kapasitas | Operasi untuk bekerja dengan kapasitas. |
| Dasbor | Operasi untuk bekerja dengan dasbor. |
| Akun Penyimpanan Aliran Data | Operasi untuk bekerja dengan akun penyimpanan aliran data. |
| Aliran data | Operasi untuk bekerja dengan aliran data. |
| Himpunan data | Operasi untuk bekerja dengan himpunan data. |
| Sematkan Token | Operasi untuk bekerja dengan token yang disematkan. |
| Gateway | Operasi untuk bekerja dengan gateway. |
| Grup | Operasi untuk bekerja dengan grup. |
| Impor | Operasi untuk bekerja dengan impor. |
| Pipelines | Operasi untuk bekerja dengan alur penyebaran. |
| Mendorong Himpunan Data | Operasi untuk bekerja dengan himpunan data push. |
| Laporan | Operasi untuk bekerja dengan laporan. |
| Aplikasi Templat | Operasi untuk bekerja dengan Aplikasi Templat. |
| Pengguna | Operasi untuk bekerja dengan pengguna. |