Datasets - Update Parameters

Başvuru

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ştirmeler.

Not

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

Önemli

Gelişmiş veri kümesi meta verileri 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.

İzinler

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

Gerekli Kapsam

Dataset.ReadWrite.All

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 Tablosal 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ısı 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.
Parametrenin IsRequired boş olmayan bir değeri 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