Gateways - Get Gateways

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste der Gateways zurück, für die der Benutzer ein Administrator ist.

Berechtigungen

Der Benutzer muss über Gatewayadministratorberechtigungen verfügen.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Einschränkungen

Virtuelle Netzwerk-Gateways (VNet) werden nicht unterstützt.

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

Antworten

Name	Typ	Beschreibung
200 OK	Gateways	OK

Beispiele

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

Definitionen

Name	Beschreibung
Gateway	Ein Power BI-Gateway
GatewayPublicKey	Ein öffentlicher Power BI-Gatewayschlüssel
Gateways	Der OData-Antwortumbruch für eine Liste von Power BI-Gateways

Gateway

Ein Power BI-Gateway

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

GatewayPublicKey

Ein öffentlicher Power BI-Gatewayschlüssel

Name	Typ	Beschreibung
exponent	string	Der öffentliche Schlüssel-Exponent
modulus	string	Das öffentliche Schlüsselmodul

Gateways

Der OData-Antwortumbruch für eine Liste von Power BI-Gateways

Name	Typ	Beschreibung
odata.context	string
value	Gateway[]	Liste der Gateways