Datasets - Update Parameters

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Çalışma alanım'dan belirtilen veri kümesi için parametre değerlerini güncelleştirir.

Uyarı

Bu API çağrısıyla gelişmiş veri kümesi meta verilerini kullanmanızı öneririz.

Önemli

Gelişmiş veri kümesi meta verilerini kullanıyorsanız yeni parametre değerlerini uygulamak için veri kümesini yenileyin.
Gelişmiş veri kümesi meta verilerini kullanmıyorsanız, veri kaynaklarını güncelleştirme işleminin tamamlanması için 30 dakika bekleyin ve ardından veri kümesini yenileyin.

Permissions

Kullanıcının veri kümesi sahibi olması gerekir.

Gerekli Kapsam

Veri Kümesi.OkumaYazma.Tümü

Sınırlamalar

Genel XMLA uç noktası kullanılarak oluşturulan veya değiştirilen veri kümeleri desteklenmez. Bu veri kümelerinde değişiklik yapmak için yöneticinin Tablolu Nesne Modeli için Azure Analysis Services istemci kitaplığını kullanması gerekir.
DirectQuery bağlantıları yalnızca gelişmiş veri kümesi meta verileriyle desteklenir.
Azure Analysis Services canlı bağlantıları olan veri kümeleri desteklenmez.
İstek başına en fazla 100 parametre.
Belirtilen tüm parametreler veri kümesinde bulunmalıdır.
Parametre değerleri beklenen türde olmalıdır.
Parametre listesi boş olamaz veya yinelenen parametreler içeremez.
Parametre adları büyük/küçük harfe duyarlıdır.
Parametre IsRequired boş olmayan bir değere sahip olmalıdır.
parametre türleri Any ve Binary güncelleştirilemez.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kimliği

İstek Gövdesi

Name	Gerekli	Tür	Description
updateDetails	True	UpdateMashupParameterDetails[]	Güncelleştirilecek veri kümesi parametrelerinin listesi

Yanıtlar

Name	Tür	Description
200 OK		Tamam

Örnekler

Example

Örnek isteği

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

İstek Gövdesi

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

Örnek yanıt

Durum kodu:: 200

Tanımlar

Name	Description
UpdateMashupParameterDetails	Power BI veri kümesi parametresinin güncelleştirme ayrıntıları
UpdateMashupParametersRequest	Power BI veri kümesi parametresi için güncelleştirme isteği

UpdateMashupParameterDetails

Object

Power BI veri kümesi parametresinin güncelleştirme ayrıntıları

Name	Tür	Description
name	string	Parametre adı
newValue	string	parametresi için yeni değer

UpdateMashupParametersRequest

Object

Power BI veri kümesi parametresi için güncelleştirme isteği

Name	Tür	Description
updateDetails	UpdateMashupParameterDetails[]	Güncelleştirilecek veri kümesi parametrelerinin listesi