Datasets - Discover Gateways In Group

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é de l’espace de travail spécifié 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.

Autorisations

Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : Profils de principal de service dans Power BI Embedded.

Étendue requise

Dataset.Read.All

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasetId	path	True	string	ID du jeu de données
groupId	path	True	string uuid	L’ID de l’espace de travail

Réponses

Nom	Type	Description
200 OK	Gateways	Ok

Exemples

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

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

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

Une 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