Datasets - Bind To Gateway

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Associa o modelo semântico especificado ao gateway especificado, opcionalmente com um determinado conjunto de IDs da fonte de dados. O modelo semântico pode residir em Meu workspace ou outro workspace, desde que o chamador tenha as permissões necessárias. Se você não fornecer uma ID de fonte de dados específica, o modelo semântico 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.