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

Имя В Обязательно Тип Описание
datasetId
 path True

string

Идентификатор набора данных

Текст запроса

Имя Обязательно Тип Описание
gatewayObjectId True

string

Идентификатор шлюза. При использовании кластера шлюза идентификатор шлюза ссылается на основной (первый) шлюз в кластере и аналогичен идентификатору кластера шлюза.
datasourceObjectIds

string[]

Уникальные идентификаторы источников данных в шлюзе

Ответы

Имя Тип Описание
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

Привязка набора данных к запросу шлюза

Имя Тип Описание
datasourceObjectIds

string[]

Уникальные идентификаторы источников данных в шлюзе
gatewayObjectId

string

Идентификатор шлюза. При использовании кластера шлюза идентификатор шлюза ссылается на основной (первый) шлюз в кластере и аналогичен идентификатору кластера шлюза.