Reports - Bind To Gateway

Dienst:: Power BI REST APIs

API-Version:: v1.0

Bindet die angegebene Datenquelle des paginierten Berichts von My workspace an das angegebene Gateway, optional mit einer bestimmten Datenquellen-ID. Wenn Sie keine bestimmte Datenquellen-ID angeben, wird die Datenquelle an die erste übereinstimmende Datenquelle im Gateway gebunden.

Erlaubnisse

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden.

Erforderliche delegierte Bereiche

Report.ReadWrite.All oder Report.Read.All

Einschränkungen

Unterstützt nur lokales Datengateway

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
reportId	path	True	string (uuid)	Die Berichts-ID

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
bindDetails	True	RdlBindDetail[]	Liste der Bindungsdetails
gatewayObjectId	True	string (uuid)	Die Gateway-ID. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.

Antworten

Name	Typ	Beschreibung
200 OK		OKAY

Beispiele

Example

Beispielanforderung

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

Anforderungstext

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

Beispiel für eine Antwort

Statuscode:: 200

Definitionen

Name	Beschreibung
RdlBindDetail	BindDetail für jede Datenquelle in einem paginierten Bericht
RdlBindToGatewayRequest	Paginierter Bericht bindet Datenquelle an Gatewayanforderung

RdlBindDetail

Objekt

BindDetail für jede Datenquelle in einem paginierten Bericht

Name	Typ	Beschreibung
dataSourceName	string	Name der Datenquelle im paginierten Bericht
dataSourceObjectId	string (uuid)	Der eindeutige Bezeichner für die Datenquelle im Gateway

RdlBindToGatewayRequest