Leer en inglés

Compartir a través de


Datasets - Bind To Gateway

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

El identificador del conjunto de datos

Cuerpo de la solicitud

Nombre Requerido Tipo Description
gatewayObjectId True

string

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[]

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

Respuestas

Nombre Tipo Description
200 OK

Aceptar

Ejemplos

Example with 'datasourceObjectIds'

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Sample Response

Definiciones

BindToGatewayRequest

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

Nombre Tipo Description
datasourceObjectIds

string[]

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

gatewayObjectId

string

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.