Compartir a través de

Datasets - Bind To Gateway In Group

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

Enlaza el conjunto de datos especificado desde el área de trabajo especificada 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.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Dataset.ReadWrite.All

Limitaciones

Solo admite la puerta de enlace de datos local.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
datasetId
 path True

string

Identificador del conjunto de datos
groupId
 path True

string

uuid

Identificador del área de trabajo

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 de los orígenes de datos de la puerta de enlace

Respuestas

Nombre Tipo Description
200 OK

Aceptar

Ejemplos

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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

Conjunto de datos de enlace a solicitud de puerta de enlace

Nombre Tipo Description
datasourceObjectIds

string[]

Identificadores únicos de 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.