Gateways - Get Gateway

Service:

Power BI REST APIs

API Version:

v1.0

Restituisce il gateway specificato.

Autorizzazioni

L'utente deve disporre delle autorizzazioni di amministratore del gateway.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

Limitazioni

I gateway di rete virtuale non sono supportati.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
gatewayId	path	True	string uuid	ID gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster. In questi casi, l'ID del gateway è simile all'ID del cluster gateway.

Risposte

Nome	Tipo	Descrizione
200 OK	Gateway	OK

Esempio

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="
  }
}

Definizioni

Nome	Descrizione
Gateway	Un gateway di Power BI
GatewayPublicKey	Chiave pubblica del gateway Power BI

Gateway

Un gateway di Power BI

Nome	Tipo	Descrizione
gatewayAnnotation	string	Metadati del gateway in formato JSON
gatewayStatus	string	Stato della connettività del gateway
id	string	ID gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID del cluster gateway.
name	string	Nome del gateway
publicKey	GatewayPublicKey	Chiave pubblica del gateway
type	string	Tipo di gateway

GatewayPublicKey

Chiave pubblica del gateway Power BI

Nome	Tipo	Descrizione
exponent	string	Esponente della chiave pubblica
modulus	string	Modulo di chiave pubblica