Udostępnij przez

Datasets - Bind To Gateway

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Wiąże określony zestaw danych z 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 (uuid)

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

string[] (uuid)

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'

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Treść żądania
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceObjectIds": [
    "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb",
    "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
  ]
}

Przykładowa odpowiedź

Kod stanu:
200

Example without 'datasourceObjectIds'

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Treść żądania
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Przykładowa odpowiedź

Kod stanu:
200

Definicje

BindToGatewayRequest

Objekt

Powiązany zestaw danych z żądaniem bramy

Nazwa Typ Opis
datasourceObjectIds

string[] (uuid)

Unikatowe identyfikatory źródeł danych w bramie
gatewayObjectId

string (uuid)

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