Compartilhar via


Datasets - Bind To Gateway

Associa o conjunto de dados especificado do 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 segurança do chamador 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

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 de gateway.

datasourceObjectIds

string[]

Os identificadores exclusivos para as fontes de dados no gateway

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

Example with 'datasourceObjectIds'
Example without 'datasourceObjectIds'

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

Definições

BindToGatewayRequest

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

Nome Tipo Description
datasourceObjectIds

string[]

Os identificadores exclusivos para as fontes de dados no gateway

gatewayObjectId

string

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 de gateway.