共用方式為

Datasets - Bind To Gateway In Group

  • 參考
服務:
Power BI REST APIs
API 版本:
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 (uuid)

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

string[] (uuid)

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

回應

名稱 類型 Description
200 OK

還行

範例

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

範例要求

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

範例回覆

狀態碼:
200

Example without 'datasourceObjectIds'

範例要求

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

範例回覆

狀態碼:
200

定義

BindToGatewayRequest

Object

系結數據集至閘道要求

名稱 類型 Description
datasourceObjectIds

string[] (uuid)

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

string (uuid)

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