Sdílet prostřednictvím

Datasets - Bind To Gateway

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

Vytvoří vazbu zadané datové sady z 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ě.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Podporuje pouze místní bránu dat.

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

Parametry identifikátoru URI

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

string

ID datové sady

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/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

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.