Datasets - Update Parameters In Group

服務:

Power BI REST APIs

API 版本:

v1.0

從指定的工作區更新指定資料集的參數值。

備註

我們建議使用此 API 呼叫使用 增強型資料集中繼資料 。

這很重要

• 如果您使用 增強型資料集中繼資料，請重新整理資料集以套用新的參數值。
• 如果您未使用 增強型資料集中繼資料，請等待 30 分鐘讓更新資料來源作業完成，然後重新整理資料集。

權限

• 使用者必須是資料集擁有者。
• 此 API 呼叫可由服務主體設定檔呼叫。 如需詳細資訊，請參閱： Power BI Embedded 中的服務主體設定檔。

必要範圍

Dataset.ReadWrite.All

局限性

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

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

URI 參數

名稱	位於	必要	類型	Description
datasetId	path	True	string
groupId	path	True	string (uuid)	工作區識別碼

要求本文

名稱	必要	類型	Description
updateDetails	True	UpdateMashupParameterDetails[]	要更新的資料集參數清單

回應

名稱	類型	Description
200 OK		OK

範例

Example

範例要求

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

要求本文

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

範例回覆

狀態碼:

200

定義

名稱	Description
UpdateMashupParameterDetails	Power BI 資料集參數的更新詳細資料
UpdateMashupParametersRequest	Power BI 資料集參數的更新要求

UpdateMashupParameterDetails

Object

Power BI 資料集參數的更新詳細資料

名稱	類型	Description
name	string	參數名稱
newValue	string	參數的新值

UpdateMashupParametersRequest

Object

Power BI 資料集參數的更新要求

名稱	類型	Description
updateDetails	UpdateMashupParameterDetails[]	要更新的資料集參數清單