Reports - Bind To Gateway

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

Wiąże określone źródło danych raportu podzielonego na strony z Mój obszar roboczy z określoną bramą, opcjonalnie z danym identyfikatorem źródła danych. Jeśli nie podasz określonego identyfikatora źródła danych, źródło danych zostanie powiązane z pierwszym pasującym źródłem danych w bramie.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi.

Wymagane zakresy delegowane

Report.ReadWrite.All lub Report.Read.All

Ograniczenia

Obsługuje tylko lokalną bramę danych

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/Default.BindToGateway

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
reportId	path	True	string (uuid)	Identyfikator raportu

Treść żądania

Nazwa	Wymagane	Typ	Opis
bindDetails	True	RdlBindDetail[]	Lista szczegółów powiązania
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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		OK

Przykłady

Example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway

Treść żądania

{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "bindDetails": [
    {
      "dataSourceName": "DataSource1",
      "dataSourceObjectId": "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb"
    },
    {
      "dataSourceName": "DataSource2",
      "dataSourceObjectId": "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
    }
  ]
}

Przykładowa odpowiedź

Kod stanu:: 200

Definicje

Nazwa	Opis
RdlBindDetail	BindDetail dla każdego źródła danych w raporcie podzielonym na strony
RdlBindToGatewayRequest	Raport podzielony na strony wiąże źródło danych z żądaniem bramy

RdlBindDetail

Objekt

BindDetail dla każdego źródła danych w raporcie podzielonym na strony

Nazwa	Typ	Opis
dataSourceName	string	Nazwa źródła danych w raporcie podzielonym na strony
dataSourceObjectId	string (uuid)	Unikatowy identyfikator źródła danych w bramie

RdlBindToGatewayRequest