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
Menyematkan 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 Microsoft Azure ACTIVE Directory menetapkan izin untuk sumber daya Power BI REST, dan memungkinkan akses ke REST API Power BI. Untuk mempelajari cara mendaftarkan aplikasi, lihat Mendaftarkan aplikasi Microsoft Azure AD untuk digunakan dengan Power BI.
Setelah mendaftarkan aplikasi Microsoft Azure AD, Anda dapat mengautentikasi terhadapnya menggunakan Microsoft 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)?
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 Microsoft Azure ACTIVE Directory Anda, ikuti langkah-langkah berikut:
Buka Aplikasi Anda di Azure.
Dari sebelah kiri, di bawah Kelola, pilih izin API .
Pilih Tambahkan izin.
Di jendela izin API Permintaan, 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 Microsoft Azure ACTIVE Directory 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.
Throttling
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 dalam waktu 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.
Mengunduh di seluruh wilayah geografis
Operasi yang melibatkan pengunduhan file di wilayah yang berbeda dari wilayah tempat panggilan dijalankan, mungkin memakan waktu lebih lama dari yang diharapkan.
Grup Operasi REST
Tabel ini mencantumkan grup operasi Power BI REST API.
Pelajari cara mengamankan, berbagi, dan menerbitkan Microsoft Power BI laporan sebagai bagian dari Power BI layanan. Memahami ruang kerja dan sertifikasi.
Menunjukkan metode dan praktik terbaik yang selaras dengan persyaratan bisnis dan teknis untuk pemodelan, visualisasi, dan analisis data dengan Microsoft Power BI.