Datasets - Get Parameters In Group

Service:

Power BI REST APIs

API Version:

v1.0

從指定的工作區傳回指定數據集的參數清單。

權限

此 API 呼叫可由服務主體配置檔呼叫。 如需詳細資訊，請參閱：Power BI Embedded 中的服務主體配置檔。

必要範圍

Dataset.Read.All 或 Dataset.ReadWrite.All

限制

• 不支援具有 SQL、Oracle、Teradata 和 SAP HANA DirectQuery 連線的數據集。
• 不支援使用公用 XMLA 端點 建立或修改的數據集。
  
  

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/parameters

URI 參數

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

回應

名稱	類型	Description
200 OK	MashupParameters	確定

範例

Example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "name": "ServerName",
      "type": "Text",
      "isRequired": true,
      "currentValue": "MyTest.database.windows.net"
    },
    {
      "name": "DatabaseName",
      "type": "Text",
      "isRequired": true,
      "currentValue": "MyTestDB"
    },
    {
      "name": "FromDate",
      "type": "DateTime",
      "isRequired": true,
      "currentValue": "2/8/2002 12:00:00 AM"
    },
    {
      "name": "FilterBlanks",
      "type": "Logical",
      "isRequired": true,
      "currentValue": "TRUE"
    },
    {
      "name": "MaxId",
      "type": "Number",
      "isRequired": true,
      "currentValue": "77"
    },
    {
      "name": "AnyParam",
      "type": "Any",
      "isRequired": true,
      "currentValue": "uu63"
    }
  ]
}

定義

名稱	Description
MashupParameter	Power BI 數據集參數
MashupParameters	Power BI 資料集參數清單的 OData 回應包裝函式

MashupParameter

Power BI 數據集參數

名稱	類型	Description
currentValue	string	參數的目前值
isRequired	boolean	是否需要數據集參數
name	string	參數名稱
suggestedValues	string[]	建議的參數值清單
type	string	參數類型

MashupParameters

Power BI 資料集參數清單的 OData 回應包裝函式

名稱	類型	Description
odata.context	string
value	MashupParameter[]	數據集參數的清單