Udostępnij za pośrednictwem

Datasets - Bind To Gateway In Group

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

Tworzy powiązanie określonego zestawu danych z określonego obszaru roboczego 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ę wywołującą interfejs API jako użytkownika źródła danych w bramie.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Zakres wymagany

Dataset.ReadWrite.All

Ograniczenia

Obsługuje tylko lokalną bramę danych

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

Identyfikator zestawu danych
groupId
 path True

string

uuid

Identyfikator obszaru roboczego

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

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.