Datasets - Update Parameters In Group

Service:

Power BI REST APIs

API Version:

v1.0

Belirtilen çalışma alanından 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.
• Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embedded hizmet sorumlusu profilleri.

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.
• Canlı bağlantıları Azure Analysis Services 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/groups/{groupId}/datasets/{datasetId}/Default.UpdateParameters

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string
groupId	path	True	string uuid	Çalışma alanı 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

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

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

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

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