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 |
---|---|---|---|---|
dataset
|
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. |