Gateways - Get Gateway

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt das angegebene Gateway zurück.

Erlaubnisse

Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Einschränkungen

VNet-Gateways (Virtual Network) werden nicht unterstützt.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
gatewayId	path	True	string (uuid)	Die Gateway-ID. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster. In solchen Fällen ähnelt die Gateway-ID der Gatewaycluster-ID.

Antworten

Name	Typ	Beschreibung
200 OK	Gateway	OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "name": "My_Sample_Gateway",
  "type": "Resource",
  "publicKey": {
    "exponent": "AQAB",
    "modulus": "o6j2....cLk="
  }
}

Definitionen

Name	Beschreibung
Gateway	Ein Power BI-Gateway
GatewayPublicKey	Öffentlicher Schlüssel für ein Power BI-Gateway

Gateway

Objekt

Ein Power BI-Gateway

Name	Typ	Beschreibung
gatewayAnnotation	string	Gatewaymetadaten im JSON-Format
gatewayStatus	string	Der Gatewaykonnektivitätsstatus
id	string (uuid)	Die Gateway-ID. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.
name	string	Der Gatewayname
publicKey	GatewayPublicKey	Öffentlicher Gatewayschlüssel
type	string	Der Gatewaytyp

GatewayPublicKey