共用方式為

Datasets - Bind To Gateway In Group

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

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

重要

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

權限

此 API 呼叫可由服務主體設定檔呼叫。 如需詳細資訊，請參閱：Power BI Embedded中的服務主體設定檔。

必要範圍

Dataset.ReadWrite.All

限制

僅支援內部部署資料閘道

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

URI 參數

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

string

資料集識別碼
groupId
 path True

string

uuid

工作區識別碼

要求本文

名稱 必要 類型 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/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

系結資料集至閘道要求

名稱 類型 Description
datasourceObjectIds

string[]

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

string

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