Datasets - Discover Gateways

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste von Gateways zurück, an die das angegebene Dataset aus Meinem Arbeitsbereich gebunden werden kann.

Dieser API-Aufruf ist nur für Datasets relevant, die mindestens eine lokale Verbindung aufweisen. Bei Datasets mit nur cloudgeschützten Verbindungen 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	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:: 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	Ein öffentlicher Power BI-Gatewayschlüssel
Gateways	Der OData-Antwortwrapper 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 Status der Gatewaykonnektivität
id	string	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	Der öffentliche Gatewayschlüssel
type	string	Der Gatewaytyp

GatewayPublicKey

Ein öffentlicher Power BI-Gatewayschlüssel

Name	Typ	Beschreibung
exponent	string	Der exponent für öffentliche Schlüssel
modulus	string	Das Öffentliche Schlüsselmodul

Gateways

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

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

Freigeben über