Compartilhar via

Datasets - Bind To Gateway

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Associa o conjunto de dados especificado de Meu workspace ao gateway especificado, opcionalmente com um determinado conjunto de IDs de fonte de dados. Se você não fornecer uma ID de fonte de dados específica, o conjunto de dados será associado à primeira fonte de dados correspondente no gateway.

Importante

Adicione a entidade de chamada de API como um usuário de fonte de dados no gateway.

Escopo necessário

Dataset.ReadWrite.All

Limitações

Só dá suporte ao gateway de dados local 

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
 path True

string

A ID do conjunto de dados

Corpo da solicitação

Nome Obrigatório Tipo Description
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.
datasourceObjectIds

string[] (uuid)

Os identificadores exclusivos para as fontes de dados no gateway

Respostas

Nome Tipo Description
200 OK

OKEY

Exemplos

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

Example with 'datasourceObjectIds'

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Corpo da solicitação
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceObjectIds": [
    "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb",
    "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
  ]
}

Resposta de exemplo

Código de status:
200

Example without 'datasourceObjectIds'

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway
Corpo da solicitação
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934"
}

Resposta de exemplo

Código de status:
200

Definições

BindToGatewayRequest

Objeto

O conjunto de dados de associação à solicitação de gateway

Nome Tipo Description
datasourceObjectIds

string[] (uuid)

Os identificadores exclusivos para as fontes de dados no gateway
gatewayObjectId

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.