Gateways - Get Datasources

Service:

Power BI REST APIs

API Version:

v1.0

Retorna uma lista de fontes de dados do gateway especificado.

Permissões

O usuário deve ter permissões de administrador de gateway.

Escopo Necessário

Dataset.ReadWrite.All ou Dataset.Read.All

Limitações

Não há suporte para gateways de rede virtual (VNet).

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
gatewayId	path	True	string uuid	A ID do gateway. Ao usar um cluster de gateway, a ID do gateway refere-se ao gateway primário (primeiro) no cluster. Nesses casos, a ID do gateway é semelhante à ID do cluster de gateway.

Respostas

Nome	Tipo	Description
200 OK	GatewayDatasources	OK

Exemplos

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

Definições

Nome	Description
credentialType	O tipo de credencial da fonte de dados
GatewayDatasource	Uma fonte de dados do gateway do Power BI
GatewayDatasourceCredentialDetails	Os detalhes da credencial da fonte de dados
GatewayDatasources	O wrapper de resposta OData para uma coleção de fontes de dados do gateway do Power BI

credentialType

O tipo de credencial da fonte de dados

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

GatewayDatasource

Uma fonte de dados do gateway do Power BI

Nome	Tipo	Description
connectionDetails	string	Detalhes da conexão no formato JSON
credentialDetails	GatewayDatasourceCredentialDetails	Os detalhes da conexão para a fonte de dados que precisa ser atualizada. Os detalhes da conexão são obrigatórios quando o conjunto de dados tem mais de uma fonte de dados.
credentialType	credentialType	O tipo de credencial da fonte de dados
datasourceName	string	O nome da fonte de dados
datasourceType	string	O tipo de fonte de dados. Nome da API para a fonte de dados Active Directory AdobeAnalytics AdoDotNet AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Exchange Extensão Facebook Arquivo Pasta GoogleAnalytics Hdfs HDInsight Informix MQ MySql OData ODBCODBC OleDb Oracle PostgreSql PowerQueryMashup PubNub Salesforce SAPBW SAPBWMessageServer SapErp SAPHana SharePoint SharePointDocLib SharePointList Sql Sybase Teradata UIFlow Web
gatewayId	string	A ID do gateway associado. Ao usar um cluster de gateway, a ID do gateway refere-se ao gateway primário (primeiro) no cluster e é semelhante à ID do cluster de gateway.
id	string	A ID exclusiva para a fonte de dados

GatewayDatasourceCredentialDetails

Os detalhes da credencial da fonte de dados

Nome	Tipo	Description
useEndUserOAuth2Credentials	boolean	Se a identidade de Azure AD do usuário final (credenciais do OAuth 2.0) é usada ao se conectar à fonte de dados no modo DirectQuery. Use com fontes de dados que dão suporte ao SSO (logon único).

GatewayDatasources

O wrapper de resposta OData para uma coleção de fontes de dados do gateway do Power BI

Nome	Tipo	Description
odata.context	string	Contexto OData
value	GatewayDatasource[]	A lista de fontes de dados do gateway