Datasets - Update Parameters In Group

Service:

Power BI REST APIs

API Version:

v1.0

汇报指定工作区中指定数据集的参数值。

注意

建议通过此 API 调用使用 增强型数据集元数据 。

重要

• 如果使用 增强型数据集元数据，请刷新数据集以应用新参数值。
• 如果不使用 增强型数据集元数据，请等待 30 分钟，等待更新数据源操作完成，然后刷新数据集。

权限

• 用户必须是数据集所有者。
• 此 API 调用可由服务主体配置文件调用。 有关详细信息，请参阅：Power BI Embedded 中的服务主体配置文件。

所需范围

Dataset.ReadWrite.All

限制

• 不支持使用公共 XMLA 终结点 创建或修改的数据集。 若要对这些数据集进行更改，管理员必须使用表格对象模型的Azure Analysis Services客户端库。
• 只有增强的数据集元数据才支持 DirectQuery 连接。
• 不支持具有Azure Analysis Services实时连接的数据集。
• 每个请求最多 100 个参数。
• 数据集中必须存在所有指定的参数。
• 参数值应为预期类型。
• 参数列表不能为空，也不能包含重复的参数。
• 参数名称区分大小写。
• 参数 IsRequired 必须具有非空值。
• 参数类型 Any 和 Binary 无法更新。
  
  

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

URI 参数

名称	在	必需	类型	说明
datasetId	path	True	string
groupId	path	True	string uuid	工作区 ID

请求正文

名称	必需	类型	说明
updateDetails	True	UpdateMashupParameterDetails[]	要更新的数据集参数列表

响应

名称	类型	说明
200 OK		确定

示例

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

定义

名称	说明
UpdateMashupParameterDetails	Power BI 数据集参数的更新详细信息
UpdateMashupParametersRequest	Power BI 数据集参数的更新请求

UpdateMashupParameterDetails

Power BI 数据集参数的更新详细信息

名称	类型	说明
name	string	参数名称
newValue	string	参数的新值

UpdateMashupParametersRequest

Power BI 数据集参数的更新请求

名称	类型	说明
updateDetails	UpdateMashupParameterDetails[]	要更新的数据集参数列表