Baca dalam bahasa Inggris

Bagikan melalui


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

  • 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)?

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 Microsoft Azure ACTIVE Directory Anda, ikuti langkah-langkah berikut:

  1. Buka Aplikasi Anda di Azure.

  2. Dari sebelah kiri, di bawah Kelola, pilih izin API .

  3. Pilih Tambahkan izin.

  4. Di jendela izin API Permintaan, pilih Layanan Power BI.

  5. Pilih Izin yang didelegasikan. Daftar API ditampilkan.

  6. Perluas API yang ingin Anda tambahkan izinnya, dan pilih izin yang ingin Anda tambahkan ke api tersebut.

  7. Pilih Tambahkan izin.

Menghapus cakupan

Untuk menghapus izin dari aplikasi Microsoft Azure ACTIVE Directory Anda, ikuti langkah-langkah berikut:

  1. Buka Aplikasi Anda di Azure.

  2. Dari sebelah kiri, di bawah Kelola, pilih izin API .

  3. Pilih menu konteks (elipsis izin).

  4. 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.

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.
Apps 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.
Token Semat 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.
Alur 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.

Langkah berikutnya

Playground

dokumentasi analitik tersemat Power BI

.NET SDK