通过

Reports - Bind To Gateway In Group

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

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

权限

此 API 调用可由服务主体配置文件调用。

所需的委派范围

Workspace.Read.All 或 Workspace.ReadWrite.All

局限性

仅支持本地数据网关

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

URI 参数

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

string (uuid)

工作区 ID
reportId
 path True

string (uuid)

报表 ID

请求正文

名称 必需 类型 说明
bindDetails True

RdlBindDetail[]

绑定详细信息列表
gatewayObjectId True

string (uuid)

网关 ID。 使用网关群集时，网关 ID 引用群集中的主网关（第一个）网关，类似于网关群集 ID。

响应

名称 类型 说明
200 OK

还行

示例

Example

示例请求

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
请求正文
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "bindDetails": [
    {
      "dataSourceName": "DataSource1",
      "dataSourceObjectId": "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb"
    },
    {
      "dataSourceName": "DataSource2",
      "dataSourceObjectId": "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
    }
  ]
}

示例响应

状态代码:
200

定义

名称 说明
RdlBindDetail

分页报表中每个数据源的 BindDetail
RdlBindToGatewayRequest

分页报表将数据源绑定到网关请求

RdlBindDetail

Object

分页报表中每个数据源的 BindDetail

名称 类型 说明
dataSourceName

string

分页报表中数据源的名称
dataSourceObjectId

string (uuid)

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

RdlBindToGatewayRequest

Object

分页报表将数据源绑定到网关请求

名称 类型 说明
bindDetails

RdlBindDetail[]

绑定详细信息列表
gatewayObjectId

string (uuid)

网关 ID。 使用网关群集时，网关 ID 引用群集中的主网关（第一个）网关，类似于网关群集 ID。