共用方式為

Reports - Bind To Gateway

  • 參考
服務:
Power BI REST APIs
API 版本:
v1.0

將編頁報表的指定數據源從 [我的工作區] 系結至指定的網關，選擇性地使用指定的數據源標識符。 如果您未提供特定的數據源標識符，數據源將會系結至閘道中的第一個相符數據源。

權限

此 API 呼叫可由服務主體配置檔呼叫。

必要的委派範圍

Report.ReadWrite.All 或 Report.Read.All

局限性

僅支援內部部署數據閘道

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

URI 參數

名稱 位於 必要 類型 Description
reportId
 path True

string

uuid

報表標識碼

要求本文

名稱 必要 類型 Description
bindDetails True

RdlBindDetail[]

系結詳細數據清單
gatewayObjectId True

string

閘道識別碼。 使用閘道叢集時，閘道標識碼是指叢集中的主要（第一個）網關，類似於閘道叢集標識碼。

回應

名稱 類型 Description
200 OK

還行

範例

Example

Sample request

POST https://api.powerbi.com/v1.0/myorg/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"
    }
  ]
}

Sample response

Status code:
200

定義

名稱 Description
RdlBindDetail

分頁報表中每個數據源的 BindDetail
RdlBindToGatewayRequest

編頁報表將數據源系結至閘道要求

RdlBindDetail

分頁報表中每個數據源的 BindDetail

名稱 類型 Description
dataSourceName

string

編頁報表中數據源的名稱
dataSourceObjectId

string

閘道中數據源的唯一標識碼

RdlBindToGatewayRequest

編頁報表將數據源系結至閘道要求

名稱 類型 Description
bindDetails

RdlBindDetail[]

系結詳細數據清單
gatewayObjectId

string

閘道識別碼。 使用閘道叢集時，閘道標識碼是指叢集中的主要（第一個）網關，類似於閘道叢集標識碼。