Compartilhar via


Datasets - Bind To Gateway In Group

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