Datasets - Discover Gateways In Group

Service:

Power BI REST APIs

API Version:

v1.0

Devuelve una lista de puertas de enlace a las que se puede enlazar el conjunto de datos especificado del área de trabajo especificada.

Esta llamada API solo es relevante para los conjuntos de datos que tienen al menos una conexión local. En el caso de los conjuntos de datos con conexiones solo en la nube, esta llamada API devuelve una lista vacía.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Dataset.Read.All

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string	El identificador del conjunto de datos
groupId	path	True	string uuid	Identificador del área de trabajo

Respuestas

Nombre	Tipo	Description
200 OK	Gateways	Aceptar

Ejemplos

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

Definiciones

Nombre	Description
Gateway	Una puerta de enlace de Power BI
GatewayPublicKey	Una clave pública de puerta de enlace de Power BI
Gateways	Contenedor de respuesta de OData para obtener una lista de puertas 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

Gateways

Contenedor de respuesta de OData para obtener una lista de puertas de enlace de Power BI

Nombre	Tipo	Description
odata.context	string
value	Gateway[]	Lista de puertas de enlace