Gateways - Get Gateway

Service:

Power BI REST APIs

API Version:

v1.0

Retorna o gateway especificado.

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/{gatewayId}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
gatewayId	path	True	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. Nesses casos, a ID do gateway é semelhante à ID do cluster de gateway.

Respostas

Nome	Tipo	Description
200 OK	Gateway	OK

Exemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934

Sample Response

Status code:

200

{
  "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

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