通过

Datasets - Update Parameters In Group

服务:
Power BI REST APIs
API 版本:
v1.0

从指定的工作区更新指定数据集的参数值。

注释

建议使用此 API 调用的 增强数据集元数据 。

重要

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

Permissions

所需范围

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

示例请求

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

定义

名称 说明
UpdateMashupParameterDetails

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

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

UpdateMashupParameterDetails

Object

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

名称 类型 说明
name

string

参数名称
newValue

string

参数的新值

UpdateMashupParametersRequest

Object

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

名称 类型 说明
updateDetails

UpdateMashupParameterDetails[]

要更新的数据集参数列表