Partilhar via

Gateways - Get Datasource

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna a fonte de dados especificada 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/{datasourceId}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasourceId
 path True

string (uuid)

A ID da fonte de dados
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 do gateway.

Respostas

Nome Tipo Description
200 OK

GatewayDatasource

OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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"
}

Definições

Nome Description
credentialType

O tipo de fonte de dados de credencial
GatewayDatasource

Uma fonte de dados do gateway do Power BI
GatewayDatasourceCredentialDetails

Os detalhes da credencial da fonte de dados

credentialType

Enumeração

O tipo de fonte de dados de credencial

Valor Description
Basic
Windows
Anonymous
OAuth2
Key
SAS

GatewayDatasource

Objeto

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 de atualização. 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 fonte de dados de credencial
datasourceName

string

O nome da fonte de dados
datasourceType

string

O tipo de fonte de dados .

Nome da API para a fonte de dados
ActiveDirectory AdobeAnalytics AdoDotNet
AnalysisServices AzureBlobs AzureDataLakeStorage
AzureMarketplace AzureTables BizTalk
CDPA CustomConnector CustomHttpApi
DB2 Essbase EventHub
Excel Troca Extensão
Facebook Arquivo Pasta
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)

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 do gateway.
id

string (uuid)

A ID exclusiva da fonte de dados

GatewayDatasourceCredentialDetails

Objeto

Os detalhes da credencial da fonte de dados

Nome Tipo Description
useEndUserOAuth2Credentials

boolean

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