Gateways - Get Datasource

Servicio:

Power BI REST APIs

Versión de la API:

v1.0

Devuelve el origen de datos especificado 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/{datasourceId}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasourceId	path	True	string (uuid)	Identificador del origen de datos
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 de clúster de puerta de enlace.

Respuestas

Nombre	Tipo	Description
200 OK	GatewayDatasource	De acuerdo

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970

Respuesta de muestra

status code:

200

{
  "id": "252b9de8-d915-4788-aaeb-ec8c2395f970",
  "gatewayId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "datasourceType": "Sql",
  "connectionDetails": "{\"server\":\"MyServer\",\"database\":\"MyDatabase\"}",
  "credentialType": "Windows",
  "datasourceName": "Sample Datasource"
}

Definiciones

Nombre	Description
credentialType	Tipo de de credenciales de origen de datos
GatewayDatasource	Un origen de datos de puerta de enlace de Power BI
GatewayDatasourceCredentialDetails	Detalles de las credenciales del origen de datos

credentialType

Enumeración

Tipo de de credenciales de origen de datos

Valor	Description
Basic
Windows
Anonymous
OAuth2
Key
SAS

GatewayDatasource

Object

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	Los 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	Tipo de de credenciales de origen de datos
datasourceName	string	Nombre del origen de datos
datasourceType	string	Tipo de origen de datos de . Nombre de API para el origen de datos ActiveDirectory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Intercambio Extensión Facebook Archivo Carpeta GoogleAnalytics Hdfs HDInsight Informix MQ MySql OData ODBC OleDb Oráculo PostgreSql PowerQueryMashup PubNub Salesforce SAPBW SAPBWMessageServer SapErp SAPHana SharePoint SharePointDocLib SharePointList Sql Sybase Teradata UIFlow Web
gatewayId	string (uuid)	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 (uuid)	Identificador único del origen de datos

GatewayDatasourceCredentialDetails

Object

Detalles de las credenciales del origen de datos

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