Datasets - Discover Gateways

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste von Gateways zurück, an die das angegebene Semantikmodell gebunden werden kann. Das Semantikmodell kann sich im Arbeitsbereich "Mein Arbeitsbereich" oder in einem anderen Arbeitsbereich befinden, vorausgesetzt, der Aufrufer verfügt über die erforderlichen Berechtigungen.

Dieser API-Aufruf ist nur für Datasets relevant, die mindestens eine lokale Verbindung haben. Für Datasets mit reinen Cloudverbindungen gibt dieser API-Aufruf eine leere Liste zurück.

Erforderlicher Bereich

Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.DiscoverGateways

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID

Antworten

Name	Typ	Beschreibung
200 OK	Gateways	OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "ContosoGateway",
      "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
Gateways	Der OData-Antwortwrapper für eine Liste von Power BI-Gateways

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

Objekt

Öffentlicher Schlüssel für ein Power BI-Gateway

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

Gateways

Objekt

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

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