Datasets - Bind To Gateway In Group

Associa il set di dati specificato dall'area di lavoro specificata al gateway specificato, facoltativamente con un determinato set di ID origine dati. Se non si specifica un ID origine dati specifico, il set di dati verrà associato alla prima origine dati corrispondente nel gateway.

Importante

Aggiungere l'entità chiamante API come utente dell'origine dati nel gateway.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

Supporta solo il gateway dati locale

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
datasetId
path True

string

ID del set di dati

groupId
path True

string

uuid

ID area di lavoro

Corpo della richiesta

Nome Necessario Tipo Descrizione
gatewayObjectId True

string

ID gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID del cluster gateway.

datasourceObjectIds

string[]

Identificatori univoci per le origini dati nel gateway

Risposte

Nome Tipo Descrizione
200 OK

OK

Esempio

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
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceObjectIds": [
    "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb",
    "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
  ]
}

Sample Response

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
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Sample Response

Definizioni

BindToGatewayRequest

Set di dati di associazione alla richiesta del gateway

Nome Tipo Descrizione
datasourceObjectIds

string[]

Identificatori univoci per le origini dati nel gateway

gatewayObjectId

string

ID gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID del cluster gateway.