Reports - Bind To Gateway

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

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

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API.

Ámbitos delegados necesarios

Report.ReadWrite.All o Report.Read.All

Limitaciones

Solo admite la puerta de enlace de datos local

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/Default.BindToGateway

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
reportId	path	True	string (uuid)	Identificador del informe

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
bindDetails	True	RdlBindDetail[]	Lista de detalles de enlace
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.

Respuestas

Nombre	Tipo	Description
200 OK		De acuerdo

Ejemplos

Example

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway

Cuerpo de la solicitud

{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "bindDetails": [
    {
      "dataSourceName": "DataSource1",
      "dataSourceObjectId": "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb"
    },
    {
      "dataSourceName": "DataSource2",
      "dataSourceObjectId": "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
    }
  ]
}

Respuesta de muestra

status code:: 200

Definiciones

Nombre	Description
RdlBindDetail	BindDetail para cada origen de datos de un informe paginado
RdlBindToGatewayRequest	Origen de datos de enlace de informe paginado a la solicitud de puerta de enlace

RdlBindDetail

Object

BindDetail para cada origen de datos de un informe paginado

Nombre	Tipo	Description
dataSourceName	string	Nombre del origen de datos en el informe paginado
dataSourceObjectId	string (uuid)	Identificador único del origen de datos de la puerta de enlace

RdlBindToGatewayRequest