Gateways - Get Gateway

Service:

Power BI REST APIs

API Version:

v1.0

Retourne la passerelle spécifiée.

Autorisations

L’utilisateur doit disposer d’autorisations d’administrateur de passerelle.

Étendue requise

Dataset.ReadWrite.All ou Dataset.Read.All

Limites

Les passerelles de réseau virtuel (VNet) ne sont pas prises en charge.

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
gatewayId	path	True	string uuid	ID de passerelle. Lors de l’utilisation d’un cluster de passerelle, l’ID de passerelle fait référence à la passerelle principale (première) du cluster. Dans ce cas, l’ID de passerelle est similaire à l’ID de cluster de passerelle.

Réponses

Nom	Type	Description
200 OK	Gateway	Ok

Exemples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934

Sample Response

Status code:

200

{
  "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	Clé publique de passerelle 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