Compartir a través de

Datasets - Bind To Gateway

Servicio:
Power BI REST APIs
Versión de la API:
v1.0

Enlaza el conjunto de datos especificado de Mi área de trabajo a la puerta de enlace especificada, opcionalmente con un conjunto determinado de identificadores de origen de datos. Si no proporciona un identificador de origen de datos específico, el conjunto de datos se enlazará al primer origen de datos coincidente de la puerta de enlace.

Importante

Agregue la entidad de llamada de API como usuario de origen de datos en la puerta de enlace.

Ámbito requerido

Dataset.ReadWrite.All

Limitaciones

Solo admite la puerta de enlace de datos local 

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasetId
 path True

string

Identificador del conjunto de datos

Cuerpo de la solicitud

Nombre Requerido Tipo Description
gatewayObjectId True

string (uuid)

Identificador de puerta de enlace. Cuando se usa un clúster de puerta de enlace, el identificador de puerta de enlace hace referencia a la puerta de enlace principal (primera) del clúster y es similar al identificador del clúster de puerta de enlace.
datasourceObjectIds

string[] (uuid)

Identificadores únicos de los orígenes de datos de la puerta de enlace

Respuestas

Nombre Tipo Description
200 OK

De acuerdo

Ejemplos

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Cuerpo de la solicitud
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceObjectIds": [
    "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb",
    "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
  ]
}

Respuesta de muestra

status code:
200

Example without 'datasourceObjectIds'

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Cuerpo de la solicitud
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Respuesta de muestra

status code:
200

Definiciones

BindToGatewayRequest

Object

El conjunto de datos de enlace a la solicitud de puerta de enlace

Nombre Tipo Description
datasourceObjectIds

string[] (uuid)

Identificadores únicos de los orígenes de datos de la puerta de enlace
gatewayObjectId

string (uuid)

Identificador de puerta de enlace. Cuando se usa un clúster de puerta de enlace, el identificador de puerta de enlace hace referencia a la puerta de enlace principal (primera) del clúster y es similar al identificador del clúster de puerta de enlace.