Freigeben über

Datasets - Discover Gateways

Dienst:
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 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