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

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

string

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

string

uuid

идентификатор рабочей области;

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

Имя Обязательно Тип Описание
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/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

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

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

string[]

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

string

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