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

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

Имя	Тип	Описание
Anonymous	string
Basic	string
Key	string
OAuth2	string
SAS	string
Windows	string

GatewayDatasource

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

Имя	Тип	Описание
connectionDetails	string	Сведения о подключении в формате JSON
credentialDetails	GatewayDatasourceCredentialDetails	Сведения о подключении для источника данных, требующего обновления. Сведения о подключении являются обязательными, если набор данных содержит несколько источников данных.
credentialType	credentialType	Тип учетных данных источника данных
datasourceName	string	Имя источника данных.
datasourceType	string	Тип источника данных. Имя API для источника данных ActiveDirectory AdobeAnalytics AdoDotNet Analysis Services: Большие двоичные объекты Azure AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase концентратор событий. Excel Exchange Расширение Facebook Файловый Папка GoogleAnalytics Hdfs HDInsight Informix Магический квадрант MySQL OData ODBC OleDb Oracle; PostgreSQL PowerQueryMashup с помощью PubNub. Salesforce SAPBW SAPBWMessageServer SapErp SAPHana SharePoint SharePointDocLib SharePointList SQL Sybase Teradata UIFlow Интернет
gatewayId	string	Связанный идентификатор шлюза. При использовании кластера шлюза идентификатор шлюза ссылается на основной (первый) шлюз в кластере и аналогичен идентификатору кластера шлюза.
id	string	Уникальный идентификатор источника данных

GatewayDatasourceCredentialDetails

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

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

GatewayDatasources

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

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