Share via

Datasets - Bind To Gateway In Group

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

Vytvoří vazbu zadané datové sady ze zadaného pracovního prostoru na zadanou bránu, volitelně s danou sadou ID zdroje dat. Pokud nezadáte konkrétní ID zdroje dat, datová sada bude vázána na první odpovídající zdroj dat v bráně.

Důležité

Přidejte instanční objekt rozhraní API jako uživatele zdroje dat v bráně.

Oprávnění

Toto volání rozhraní API může volat profil instančního objektu. Další informace najdete v tématu: Instanční profily v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Podporuje pouze místní bránu dat.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
 path True

string

ID datové sady
groupId
 path True

string

uuid

ID pracovního prostoru

Text požadavku

Name Vyžadováno Typ Description
gatewayObjectId True

string

ID brány. Když používáte cluster brány, ID brány odkazuje na primární (první) bránu v clusteru a podobá se ID clusteru brány.
datasourceObjectIds

string[]

Jedinečné identifikátory zdrojů dat v bráně

Odpovědi

Name Typ Description
200 OK

OK

Příklady

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

Definice

BindToGatewayRequest

Žádost o vytvoření vazby datové sady k bráně

Name Typ Description
datasourceObjectIds

string[]

Jedinečné identifikátory zdrojů dat v bráně
gatewayObjectId

string

ID brány. Když používáte cluster brány, ID brány odkazuje na primární (první) bránu v clusteru a podobá se ID clusteru brány.