Datasets - Bind To Gateway

  • Referenz
Service:
Power BI REST APIs
API Version:
v1.0

Bindet das angegebene Dataset von Meinem Arbeitsbereich an das angegebene Gateway, optional mit einer bestimmten Gruppe von Datenquellen-IDs. Wenn Sie keine bestimmte Datenquellen-ID angeben, wird das Dataset an die erste übereinstimmende Datenquelle im Gateway gebunden.

Wichtig

Fügen Sie den API-Anruferprinzipal als Datenquellenbenutzer im Gateway hinzu.

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

Unterstützt nur das lokale Datengateway

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID

Anforderungstext

Name Erforderlich Typ Beschreibung
gatewayObjectId True

string

Die Gateway-ID. Bei Verwendung eines Gatewayclusters verweist die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.
datasourceObjectIds

string[]

Die eindeutigen Bezeichner für die Datenquellen im Gateway

Antworten

Name Typ Beschreibung
200 OK

OK

Beispiele

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

Definitionen

BindToGatewayRequest

Das Binden des Datasets an die Gatewayanforderung

Name Typ Beschreibung
datasourceObjectIds

string[]

Die eindeutigen Bezeichner für die Datenquellen im Gateway
gatewayObjectId

string

Die Gateway-ID. Bei Verwendung eines Gatewayclusters verweist die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.