Partager via

Datasets - Discover Gateways

Service:
Power BI REST APIs
Version d'API:
v1.0

Retourne une liste de passerelles auxquelles le jeu de données spécifié à partir de Mon espace de travail peut être lié.

Cet appel d’API s’applique uniquement aux jeux de données qui ont au moins une connexion locale. Pour les jeux de données avec des connexions cloud uniquement, cet appel d’API retourne une liste vide.

Étendue requise

Dataset.Read.All 

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

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
 path True

string

ID du jeu de données

Réponses

Nom Type Description
200 OK

Gateways

Ok

Exemples

Example

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "ContosoGateway",
      "type": "Resource",
      "publicKey": {
        "exponent": "AQAB",
        "modulus": "o6j2....cLk="
      }
    }
  ]
}

Définitions

Nom Description
Gateway

Une passerelle Power BI
GatewayPublicKey

Une clé publique de passerelle Power BI
Gateways

Wrapper de réponse OData pour une liste de passerelles Power BI

Gateway

Object

Une passerelle Power BI

Nom Type Description
gatewayAnnotation

string

Métadonnées de passerelle au format JSON
gatewayStatus

string

État de connectivité de la passerelle
id

string (uuid)

ID de passerelle. Lorsque vous utilisez un cluster de passerelle, l’ID de passerelle fait référence à la passerelle principale (première) du cluster et est similaire à l’ID de cluster de passerelle.
name

string

Nom de la passerelle
publicKey

GatewayPublicKey

Clé publique de passerelle
type

string

Type de passerelle

GatewayPublicKey

Object

Une clé publique de passerelle Power BI

Nom Type Description
exponent

string

Exposant de clé publique
modulus

string

Module de clé publique

Gateways

Object

Wrapper de réponse OData pour une liste de passerelles Power BI

Nom Type Description
@odata.context

string

value

Gateway[]

Liste des passerelles