共用方式為

Datasets - Bind To Gateway

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

將指定的資料集從 [我的工作區 ] 系結至指定的閘道，選擇性地使用一組指定的資料來源識別碼。 如果您沒有提供特定的資料來源識別碼，資料集將會系結至閘道中的第一個相符資料來源。

重要

將 API 呼叫端主體新增為閘道上的資料來源使用者。

必要範圍

Dataset.ReadWrite.All

限制

僅支援內部部署資料閘道

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

URI 參數

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

string

資料集識別碼

要求本文

名稱 必要 類型 Description
gatewayObjectId True

string

閘道識別碼。 使用閘道叢集時，閘道識別碼是指叢集中第一個) 閘道的主要 (，類似于閘道叢集識別碼。
datasourceObjectIds

string[]

閘道中資料來源的唯一識別碼

回應

名稱 類型 Description
200 OK

確定

範例

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Request Body
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Sample Response

Status code:
200

定義

BindToGatewayRequest

系結資料集至閘道要求

名稱 類型 Description
datasourceObjectIds

string[]

閘道中資料來源的唯一識別碼
gatewayObjectId

string

閘道識別碼。 使用閘道叢集時，閘道識別碼是指叢集中第一個) 閘道的主要 (，類似于閘道叢集識別碼。