Datasets - Bind To Gateway In Group

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

Bindet das angegebene Dataset aus dem angegebenen Arbeitsbereich an das angegebene Gateway, optional mit einem bestimmten Satz 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.

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

Unterstützt nur das lokale Datengateway

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
 path True

string

Die Dataset-ID
groupId
 path True

string

uuid

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

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.