共用方式為

Datasets - Update Parameters

  • 參考
Service:
Power BI REST APIs
API Version:
v1.0

匯報 [我的工作區] 中指定資料集的參數值。

注意

建議您搭配此 API 呼叫使用 增強數據集元數據 。

重要

  • 如果您使用 增強數據集元數據，請重新整理資料集以套用新的參數值。
  • 如果您未使用 增強的數據集元數據，請等候 30 分鐘，更新數據源作業才能完成，然後重新整理數據集。

權限

用戶必須是數據集擁有者。

必要範圍

Dataset.ReadWrite.All

限制

  • 不支援使用公用 XMLA 端點 建立或修改的數據集。 若要變更這些數據集，系統管理員必須使用表格式物件模型的 Azure Analysis Services 客戶端連結庫。
  • 只有增強的數據集元數據才支援 DirectQuery 連線。
  • 不支援具有 Azure Analysis Services 即時連線的數據集。
  • 每個要求最多100個參數。
  • 所有指定的參數都必須存在於數據集中。
  • 參數值應為預期的型別。
  • 參數清單不能是空的，或包含重複的參數。
  • 參數名稱會區分大小寫。
  • 參數 IsRequired 必須具有非空白值。
  • 參數類型 Any ， Binary 且無法更新。 

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

URI 參數

名稱 位於 必要 類型 Description
datasetId
 path True

string

數據集標識碼

要求本文

名稱 必要 類型 Description
updateDetails True

UpdateMashupParameterDetails[]

要更新的數據集參數清單

回應

名稱 類型 Description
200 OK

確定

範例

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
Request Body
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

Status code:
200

定義

名稱 Description
UpdateMashupParameterDetails

Power BI 數據集參數的更新詳細數據
UpdateMashupParametersRequest

Power BI 數據集參數的更新要求

UpdateMashupParameterDetails

Power BI 數據集參數的更新詳細數據

名稱 類型 Description
name

string

參數名稱
newValue

string

參數的新值

UpdateMashupParametersRequest

Power BI 數據集參數的更新要求

名稱 類型 Description
updateDetails

UpdateMashupParameterDetails[]

要更新的數據集參數清單