Gateways - Get Datasources

Service:

Power BI REST APIs

API Version:

v1.0

Devuelve una lista de orígenes de datos de 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}/datasources

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

Ejemplos

Example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
      "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "datasourceType": "Sql",
      "connectionDetails": "{\"server\":\"localSQL\",\"database\":\"salesDB\"}",
      "credentialType": "Windows",
      "datasourceName": "SQL Datasource"
    },
    {
      "id": "91f8aec2-4b32-476f-909b-3241999620ec",
      "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "datasourceType": "AnalysisServices",
      "connectionDetails": "{\"server\":\"localAS\",\"database\":\"marketingDB\"}",
      "credentialType": "Windows",
      "datasourceName": "AS Datasource"
    }
  ]
}

Definiciones

Nombre	Description
credentialType	El tipo de credencial del origen de datos
GatewayDatasource	Un origen de datos de puerta de enlace de Power BI
GatewayDatasourceCredentialDetails	Detalles de las credenciales del origen de datos
GatewayDatasources	Contenedor de respuesta de OData para una colección de orígenes de datos de puerta de enlace de Power BI

credentialType

El tipo de credencial del origen de datos

Nombre	Tipo	Description
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

GatewayDatasource

Un origen de datos de puerta de enlace de Power BI

Nombre	Tipo	Description
connectionDetails	string	Detalles de conexión en formato JSON
credentialDetails	GatewayDatasourceCredentialDetails	Detalles de conexión del origen de datos que necesita actualización. Los detalles de conexión son obligatorios cuando el conjunto de datos tiene más de un origen de datos.
credentialType	credentialType	El tipo de credencial del origen de datos
datasourceName	string	Nombre del origen de datos
datasourceType	string	Tipo de origen de datos. Nombre de la API para el origen de datos ActiveDirectory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Exchange Extensión Facebook Archivo Carpeta GoogleAnalytics Hdfs HDInsight Informix MQ MySql OData ODBC OleDb Oracle PostgreSql PowerQueryMashup PubNub Salesforce SAPBW SAPBWMessageServer SapErp SAPHana SharePoint SharePointDocLib SharePointList Sql Sybase Teradata UIFlow Web
gatewayId	string	Identificador de puerta de enlace asociado. 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.
id	string	Identificador único del origen de datos

GatewayDatasourceCredentialDetails

Detalles de las credenciales del origen de datos

Nombre	Tipo	Description
useEndUserOAuth2Credentials	boolean	Si se usa la identidad de Azure AD de usuario final (credenciales de OAuth 2.0) al conectarse al origen de datos en modo DirectQuery. Use con orígenes de datos que admitan el inicio de sesión único (SSO).

GatewayDatasources

Contenedor de respuesta de OData para una colección de orígenes de datos de puerta de enlace de Power BI

Nombre	Tipo	Description
odata.context	string	Contexto de OData
value	GatewayDatasource[]	Lista de orígenes de datos de puerta de enlace