Datasets - Discover Gateways In Group

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

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

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

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataset.Read.All

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

URI-Parameter

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

Antworten

Name	Typ	Beschreibung
200 OK	Gateways	OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

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

Freigeben über