Gateways - Get Datasource

Служба:

Power BI REST APIs

Версия API:

v1.0

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

Разрешения

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

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

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

Ограничения

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

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

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	GatewayDatasource	ОК

Примеры

Example

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

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

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

Код состояния:

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

Определения

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

credentialType

Enumeration

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

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

GatewayDatasource

Object

Источник данных шлюза 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

Object

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

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