Datasets - Update Parameters

Referensi

Layanan:: Power BI REST APIs

Versi API:: v1.0

Updates nilai parameter untuk himpunan data yang ditentukan dari Ruang kerja saya.

Catatan

Sebaiknya gunakan metadata himpunan data yang disempurnakan dengan panggilan API ini.

Penting

Jika Anda menggunakan metadata himpunan data yang disempurnakan, refresh himpunan data untuk menerapkan nilai parameter baru.
Jika Anda tidak menggunakan metadata himpunan data yang disempurnakan, tunggu 30 menit hingga operasi perbarui sumber data selesai, lalu refresh himpunan data.

Izin

Pengguna harus menjadi pemilik himpunan data.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

Batasan

Himpunan data yang dibuat atau dimodifikasi menggunakan titik akhir XMLA publik tidak didukung. Untuk membuat perubahan pada himpunan data tersebut, admin harus menggunakan pustaka klien Azure Analysis Services untuk Model Objek Tabular.
Koneksi DirectQuery hanya didukung dengan metadata himpunan data yang disempurnakan.
Himpunan data dengan koneksi langsung Azure Analysis Services tidak didukung.
Maksimum 100 parameter per permintaan.
Semua parameter yang ditentukan harus ada dalam himpunan data.
Nilai parameter harus dari jenis yang diharapkan.
Daftar parameter tidak boleh kosong atau menyertakan parameter duplikat.
Nama parameter peka huruf besar/kecil.
Parameter IsRequired harus memiliki nilai yang tidak kosong.
Jenis Any parameter dan Binary tidak dapat diperbarui.

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateParameters

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string	ID himpunan data

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
updateDetails	True	UpdateMashupParameterDetails[]	Daftar parameter himpunan data untuk diperbarui

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

Example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters

Isi Permintaan

{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Respon sampel

Kode status:: 200

Definisi

Nama	Deskripsi
UpdateMashupParameterDetails	Detail pembaruan untuk parameter himpunan data Power BI
UpdateMashupParametersRequest	Permintaan pembaruan untuk parameter himpunan data Power BI

UpdateMashupParameterDetails

Object

Detail pembaruan untuk parameter himpunan data Power BI

Nama	Jenis	Deskripsi
name	string	Nama parameter
newValue	string	Nilai baru untuk parameter

UpdateMashupParametersRequest