Udostępnij za pośrednictwem

Datasets - Bind To Gateway

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Tworzy powiązanie określonego zestawu danych z obszaru Mój obszar roboczy z określoną bramą, opcjonalnie z danym zestawem identyfikatorów źródeł danych. Jeśli nie podasz określonego identyfikatora źródła danych, zestaw danych zostanie powiązany z pierwszym pasującym źródłem danych w bramie.

Ważne

Dodaj jednostkę obiektu wywołującego interfejs API jako użytkownika źródła danych w bramie.

Wymagany zakres

Dataset.ReadWrite.All

Ograniczenia

Obsługuje tylko lokalną bramę danych

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

Identyfikator zestawu danych

Treść żądania

Nazwa Wymagane Typ Opis
gatewayObjectId True

string

Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do podstawowej (pierwszej) bramy w klastrze i jest podobny do identyfikatora klastra bramy.
datasourceObjectIds

string[]

Unikatowe identyfikatory źródeł danych w bramie

Odpowiedzi

Nazwa Typ Opis
200 OK

OK

Przykłady

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

Definicje

BindToGatewayRequest

Powiązany zestaw danych z żądaniem bramy

Nazwa Typ Opis
datasourceObjectIds

string[]

Unikatowe identyfikatory źródeł danych w bramie
gatewayObjectId

string

Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do podstawowej (pierwszej) bramy w klastrze i jest podobny do identyfikatora klastra bramy.