Condividi tramite

Gateways - Get Datasources

  • Riferimento
Service:
Power BI REST APIs
API Version:
v1.0

Restituisce un elenco di origini dati dal gateway specificato.

Autorizzazioni

L'utente deve disporre delle autorizzazioni di amministratore del gateway.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

Limitazioni

I gateway di rete virtuale (VNet) non sono supportati. 

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
gatewayId
 path True

string

uuid

ID gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster. In questi casi, l'ID gateway è simile all'ID cluster del gateway.

Risposte

Nome Tipo Descrizione
200 OK

GatewayDatasources

OK

Esempio

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

Definizioni

Nome Descrizione
credentialType

Tipo di credenziale dell'origine dati
GatewayDatasource

Un'origine dati di Power BI Gateway
GatewayDatasourceCredentialDetails

Dettagli delle credenziali dell'origine dati
GatewayDatasources

Wrapper di risposta OData per una raccolta di origini dati di Power BI Gateway

credentialType

Tipo di credenziale dell'origine dati

Nome Tipo Descrizione
Anonymous

string

Basic

string

Key

string

OAuth2

string

SAS

string

Windows

string

GatewayDatasource

Un'origine dati di Power BI Gateway

Nome Tipo Descrizione
connectionDetails

string

Dettagli della connessione in formato JSON
credentialDetails

GatewayDatasourceCredentialDetails

Dettagli della connessione per l'origine dati che richiede l'aggiornamento. I dettagli di connessione sono obbligatori quando il set di dati ha più di un'origine dati.
credentialType

credentialType

Tipo di credenziale dell'origine dati
datasourceName

string

Nome dell'origine dei dati.
datasourceType

string

Tipo di origine dati.

Nome API per l'origine dati
ActiveDirectory AdobeAnalytics AdoDotNet
AnalysisServices AzureBlobs AzureDataLakeStorage
AzureMarketplace AzureTables BizTalk
CDPA CustomConnector CustomHttpApi
DB2 Essbase Hub eventi
Excel Exchange Estensione
Facebook File Cartella
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

ID gateway associato. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID cluster del gateway.
id

string

ID univoco per l'origine dati

GatewayDatasourceCredentialDetails

Dettagli delle credenziali dell'origine dati

Nome Tipo Descrizione
useEndUserOAuth2Credentials

boolean

Indica se l'identità di Azure AD dell'utente finale (credenziali OAuth 2.0) viene usata durante la connessione all'origine dati in modalità DirectQuery. Usare con le origini dati che supportano l'accesso Single Sign-On (SSO).

GatewayDatasources

Wrapper di risposta OData per una raccolta di origini dati di Power BI Gateway

Nome Tipo Descrizione
odata.context

string

Contesto OData
value

GatewayDatasource[]

Elenco delle origini dati del gateway