通过

Datasets - Bind To Gateway In Group

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

将指定工作区中的指定数据集绑定到指定的网关，可以选择使用给定的数据源 ID 集。 如果未提供特定的数据源 ID，数据集将绑定到网关中的第一个匹配数据源。

重要

将 API 调用方主体添加为网关上的数据源用户。

权限

此 API 调用可由服务主体配置文件调用。 有关详细信息，请参阅：Power BI Embedded中的服务主体配置文件。

所需范围

Dataset.ReadWrite.All

限制

仅支持本地数据网关

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

URI 参数

名称 在 必需 类型 说明
datasetId
 path True

string

数据集 ID
groupId
 path True

string

uuid

工作区 ID

请求正文

名称 必需 类型 说明
gatewayObjectId True

string

网关 ID。 使用网关群集时，网关 ID 是指群集中第一个) 网关的主 (，类似于网关群集 ID。
datasourceObjectIds

string[]

网关中数据源的唯一标识符

响应

名称 类型 说明
200 OK

确定

示例

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Request Body
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceObjectIds": [
    "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb",
    "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
  ]
}

Sample Response

Status code:
200

Example without 'datasourceObjectIds'

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Request Body
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Sample Response

Status code:
200

定义

BindToGatewayRequest

绑定到网关请求的数据集

名称 类型 说明
datasourceObjectIds

string[]

网关中数据源的唯一标识符
gatewayObjectId

string

网关 ID。 使用网关群集时，网关 ID 是指群集中第一个) 网关的主 (，类似于网关群集 ID。