Partilhar via

Datasets - Bind To Gateway In Group

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

Associa o conjunto de dados especificado do workspace especificado 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.

Permissões

Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

Escopo Necessário

Dataset.ReadWrite.All

Limitações

Só dá suporte ao gateway de dados local

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
 path True

string

A ID do conjunto de dados
groupId
 path True

string

uuid

A ID do workspace

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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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.