Gateways - Get Datasources

  • Referência
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