Datasets - Update Parameters In Group

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Updates nilai parameter untuk himpunan data yang ditentukan dari ruang kerja yang ditentukan.

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 agar operasi sumber data pembaruan selesai, lalu refresh himpunan data.

Izin

Pengguna harus menjadi pemilik himpunan data.
Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

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/groups/{groupId}/datasets/{datasetId}/Default.UpdateParameters

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
datasetId	path	True	string
groupId	path	True	string uuid	ID ruang kerja

Isi Permintaan

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

Respons

Nama	Jenis	Deskripsi
200 OK		OK

Contoh

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters

Request Body

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

Sample Response

Status code:: 200

Definisi

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

UpdateMashupParameterDetails

Detail pembaruan untuk parameter himpunan data Power BI

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

UpdateMashupParametersRequest

Permintaan pembaruan untuk parameter himpunan data Power BI

Nama	Jenis	Deskripsi
updateDetails	UpdateMashupParameterDetails[]	Daftar parameter himpunan data yang akan diperbarui

Bagikan melalui