Compartilhar via

Datasets - Discover Gateways

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna uma lista de gateways aos quais o conjunto de dados especificado do Meu workspace pode ser associado.

Essa chamada à API é relevante apenas para conjuntos de dados que têm pelo menos uma conexão local. Para conjuntos de dados com conexões somente na nuvem, essa chamada à API retorna uma lista vazia.

Escopo necessário

Dataset.Read.All 

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.DiscoverGateways

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
 path True

string

A ID do conjunto de dados

Respostas

Nome Tipo Description
200 OK

Gateways

OKEY

Exemplos

Example

Solicitação de exemplo

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

Resposta de exemplo

Código de status:
200 
{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "ContosoGateway",
      "type": "Resource",
      "publicKey": {
        "exponent": "AQAB",
        "modulus": "o6j2....cLk="
      }
    }
  ]
}

Definições

Nome Description
Gateway

Um gateway do Power BI
GatewayPublicKey

Uma chave pública do gateway do Power BI
Gateways

O wrapper de resposta OData para uma lista de gateways do Power BI

Gateway

Objeto

Um gateway do Power BI

Nome Tipo Description
gatewayAnnotation

string

Metadados de gateway no formato JSON
gatewayStatus

string

O status de conectividade do gateway
id

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.
name

string

O nome do gateway
publicKey

GatewayPublicKey

A chave pública do gateway
type

string

O tipo de gateway

GatewayPublicKey

Objeto

Uma chave pública do gateway do Power BI

Nome Tipo Description
exponent

string

O expoente de chave pública
modulus

string

O módulo de chave pública

Gateways

Objeto

O wrapper de resposta OData para uma lista de gateways do Power BI

Nome Tipo Description
@odata.context

string

value

Gateway[]

A lista de gateways