Datasets - Bind To Gateway

  • Referência
Service:
Power BI REST APIs
API Version:
v1.0

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
Request Body
{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceObjectIds": [
    "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb",
    "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
  ]
}

Sample Response

Status code:
200

Example without 'datasourceObjectIds'

Sample Request

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

Sample Response

Status code:
200

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.