Datasets - Discover Gateways

Référence

Service:: Power BI REST APIs

API Version:: 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 est uniquement pertinent pour les 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

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

Définitions

Nom	Description
Gateway	Une passerelle Power BI
GatewayPublicKey	Clé publique de passerelle Power BI
Gateways	Wrapper de réponse OData pour une liste de passerelles Power BI

Gateway

Une passerelle Power BI

Nom	Type	Description
gatewayAnnotation	string	Métadonnées de passerelle au format JSON
gatewayStatus	string	État de la connectivité de la passerelle
id	string	ID de passerelle. Lors de l’utilisation d’un cluster de passerelle, l’ID de passerelle fait référence à la passerelle primaire (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

Clé publique de passerelle Power BI

Nom	Type	Description
exponent	string	Exposant de clé publique
modulus	string	Module de clé publique

Gateways

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

Nom	Type	Description
odata.context	string
value	Gateway[]	Liste des passerelles

Partager via