Datasets - Discover Gateways In Group

Service:

Power BI REST APIs

API Version:

v1.0

Restituisce un elenco di gateway a cui può essere associato il set di dati specificato dall'area di lavoro specificata.

Questa chiamata API è rilevante solo per i set di dati con almeno una connessione locale. Per i set di dati con connessioni solo cloud, questa chiamata API restituisce un elenco vuoto.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo entità servizio. Per altre informazioni, vedere Profili entità servizio in Power BI Embedded.

Ambito obbligatorio

Dataset.Read.All

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID del set di dati
groupId	path	True	string uuid	ID area di lavoro

Risposte

Nome	Tipo	Descrizione
200 OK	Gateways	OK

Esempio

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

Definizioni

Nome	Descrizione
Gateway	Un gateway di Power BI
GatewayPublicKey	Una chiave pubblica di Power BI Gateway
Gateways	Wrapper di risposta OData per un elenco di gateway Power BI

Gateway

Un gateway di Power BI

Nome	Tipo	Descrizione
gatewayAnnotation	string	Metadati del gateway in formato JSON
gatewayStatus	string	Stato della connettività del gateway
id	string	ID gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID cluster del gateway.
name	string	Nome del gateway
publicKey	GatewayPublicKey	Chiave pubblica del gateway
type	string	Tipo di gateway

GatewayPublicKey

Una chiave pubblica di Power BI Gateway

Nome	Tipo	Descrizione
exponent	string	Esponente della chiave pubblica
modulus	string	Modulo di chiave pubblica

Gateways

Wrapper di risposta OData per un elenco di gateway Power BI

Nome	Tipo	Descrizione
odata.context	string
value	Gateway[]	Elenco di gateway