Gateways - Get Datasources

Служба:: Power BI REST APIs

Версия API:: v1.0

Возвращает список источников данных из указанного шлюза.

Разрешения

У пользователя должны быть разрешения администратора шлюза.

Требуемая область

Dataset.ReadWrite.All или Dataset.Read.All

Ограничения

Шлюзы виртуальной сети не поддерживаются.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
gatewayId	path	True	string (uuid)	Идентификатор шлюза. При использовании кластера шлюза идентификатор шлюза ссылается на первичный (первый) шлюз в кластере. В таких случаях идентификатор шлюза аналогичен идентификатору кластера шлюза.

Ответы

Имя	Тип	Описание
200 OK	GatewayDatasources	ХОРОШО

Примеры

Example

Образец запроса

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources

Пример ответа

Код состояния:: 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"
    }
  ]
}

Определения

Имя	Описание
credentialType	Тип учетных данных источника данных
GatewayDatasource	Источник данных шлюза Power BI
GatewayDatasourceCredentialDetails	Сведения об учетных данных источника данных
GatewayDatasources	Оболочка ответа OData для коллекции источников данных шлюза Power BI

credentialType

Перечисление

Тип учетных данных источника данных

Значение	Описание
Basic
Windows
Anonymous
OAuth2
Key
SAS
KeyPair

GatewayDatasource

Объект

Источник данных шлюза Power BI

Имя

Тип

Описание

connectionDetails

string

Сведения о подключении в формате JSON

credentialDetails

GatewayDatasourceCredentialDetails

Сведения о подключении для источника данных, требующего обновления. Сведения о подключении обязательны, если набор данных имеет несколько источников данных.

credentialType

Тип учетных данных источника данных

datasourceName

string

Имя источника данных

datasourceType

string

Тип источника данных .

Имя API для источника данных
ActiveDirectory	AdobeAnalytics	AdoDotNet
AnalysisServices	Большие двоичные объекты Azure	AzureDataLakeStorage
AzureMarketplace	AzureTables	BizTalk
CDPA	CustomConnector	CustomHttpApi
DB2	Essbase	EventHub
Эксель	Обмен	Расширение
Facebook	Файл	Папка
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	Интернет

gatewayId

string (uuid)

Идентификатор связанного шлюза. При использовании кластера шлюза идентификатор шлюза ссылается на первичный (первый) шлюз в кластере и аналогичен идентификатору кластера шлюза.

string (uuid)

Уникальный идентификатор источника данных

GatewayDatasourceCredentialDetails

Объект

Сведения об учетных данных источника данных

Имя	Тип	Описание
useEndUserOAuth2Credentials	boolean	Используется ли удостоверение Azure AD конечного пользователя (учетные данные OAuth 2.0) при подключении к источнику данных в режиме DirectQuery. Используйте источники данных, поддерживающие единый вход (единый вход).

GatewayDatasources

Объект

Оболочка ответа OData для коллекции источников данных шлюза Power BI

Имя	Тип	Описание
@odata.context	string	Контекст OData
value	GatewayDatasource[]	Список источников данных шлюза