Gateways - Get Gateway

Service:

Power BI REST APIs

API Version:

v1.0

Devuelve la puerta de enlace especificada.

Permisos

El usuario debe tener permisos de administrador de puerta de enlace.

Ámbito requerido

Dataset.ReadWrite.All o Dataset.Read.All

Limitaciones

No se admiten puertas de enlace de red virtual (VNet).

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
gatewayId	path	True	string uuid	Identificador de puerta de enlace. Cuando se usa un clúster de puerta de enlace, el identificador de puerta de enlace hace referencia a la puerta de enlace principal (primera) del clúster. En tales casos, el identificador de puerta de enlace es similar al identificador del clúster de puerta de enlace.

Respuestas

Nombre	Tipo	Description
200 OK	Gateway	Aceptar

Ejemplos

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

Definiciones

Nombre	Description
Gateway	Una puerta de enlace de Power BI
GatewayPublicKey	Una clave pública de puerta de enlace de Power BI

Gateway

Una puerta de enlace de Power BI

Nombre	Tipo	Description
gatewayAnnotation	string	Metadatos de puerta de enlace en formato JSON
gatewayStatus	string	Estado de conectividad de la puerta de enlace
id	string	Identificador de puerta de enlace. Cuando se usa un clúster de puerta de enlace, el identificador de puerta de enlace hace referencia a la puerta de enlace principal (primera) del clúster y es similar al identificador del clúster de puerta de enlace.
name	string	El nombre de la puerta de enlace
publicKey	GatewayPublicKey	Clave pública de puerta de enlace
type	string	Tipo de puerta de enlace

GatewayPublicKey

Una clave pública de puerta de enlace de Power BI

Nombre	Tipo	Description
exponent	string	Exponente de clave pública
modulus	string	Módulo de clave pública