Gateways - Get Datasources

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