Reports - Bind To Gateway

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Associa a fonte de dados especificada do relatório paginado de Meu workspace ao gateway especificado, opcionalmente com uma ID de fonte de dados específica. Se você não fornecer uma ID de fonte de dados específica, a fonte de dados será associada à primeira fonte de dados correspondente no gateway.

Permissões

Essa chamada à API pode ser chamada por um perfil de entidade de serviço.

Escopos delegados necessários

Report.ReadWrite.All ou Report.Read.All

Limitações

Só dá suporte ao gateway de dados local

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
reportId	path	True	string (uuid)	A ID do relatório

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
bindDetails	True	RdlBindDetail[]	Lista de detalhes de associação
gatewayObjectId	True	string (uuid)	A ID do gateway. Ao usar um cluster de gateway, a ID do gateway refere-se ao gateway primário (primeiro) no cluster e é semelhante à ID do cluster do gateway.

Respostas

Nome	Tipo	Description
200 OK		OKEY

Exemplos

Example

Solicitação de exemplo

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

Corpo da solicitação

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

Resposta de exemplo

Código de status:: 200

Definições

Nome	Description
RdlBindDetail	BindDetail para cada fonte de dados em um relatório paginado
RdlBindToGatewayRequest	Relatório paginado associar fonte de dados à solicitação de gateway

RdlBindDetail

Objeto

BindDetail para cada fonte de dados em um relatório paginado

Nome	Tipo	Description
dataSourceName	string	Nome da fonte de dados no relatório paginado
dataSourceObjectId	string (uuid)	O identificador exclusivo da fonte de dados no gateway

RdlBindToGatewayRequest