Gateways - Get Gateways

Service:

Power BI REST APIs

API Version:

v1.0

Retorna uma lista de gateways para os quais o usuário é administrador.

Permissões

O usuário deve ter permissões de administrador do gateway.

Escopo necessário

Dataset.ReadWrite.All ou Dataset.Read.All

Limitações

Não há suporte para gateways de rede virtual (VNet).

GET https://api.powerbi.com/v1.0/myorg/gateways

Respostas

Nome	Tipo	Description
200 OK	Gateways	OK

Exemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "My_Sample_Gateway",
      "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

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	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.
name	string	O nome do gateway
publicKey	GatewayPublicKey	A chave pública do gateway
type	string	O tipo de gateway

GatewayPublicKey

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

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