Datasets - Get Gateway Datasources

Service:

Power BI REST APIs

API Version:

v1.0

从 “我的工作区”返回指定数据集的网关数据源列表。

重要

此 API 调用已弃用，请改用 Get Datasources 。

所需范围

Dataset.ReadWrite.All 或 Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.GetBoundGatewayDatasources

URI 参数

名称	在	必需	类型	说明
datasetId	path	True	string	数据集 ID

响应

名称	类型	说明
200 OK	GatewayDatasources	确定

示例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.GetBoundGatewayDatasources

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "16a54ccd-620d-4af3-9197-0b8c779a9a6d",
      "gatewayId": "7f1c4e55-544b-403f-b132-da0d3a024674",
      "datasourceType": "Sql",
      "connectionDetails": "{\"server\":\"MyServer.database.windows.net\",\"database\":\"MyDatabase\"}"
    }
  ]
}

定义

名称	说明
credentialType	数据源凭据的类型
GatewayDatasource	Power BI 网关数据源
GatewayDatasourceCredentialDetails	数据源凭据详细信息
GatewayDatasources	Power BI 网关数据源集合的 OData 响应包装器

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 AnalysisServices AzureBlobs AzureDataLakeStorage AzureMarketplace AzureTables BizTalk CDPA CustomConnector CustomHttpApi DB2 Essbase EventHub Excel Exchange 分机 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 Web
gatewayId	string	关联的网关 ID。 使用网关群集时，网关 ID 是指群集中第一个) 网关的主 (，类似于网关群集 ID。
id	string	数据源的唯一 ID

GatewayDatasourceCredentialDetails

数据源凭据详细信息

名称	类型	说明
useEndUserOAuth2Credentials	boolean	在 DirectQuery 模式下连接到数据源时，最终用户 Azure AD 标识是否 (OAuth 2.0 凭据) 。 与支持 单一登录的数据源配合使用， (SSO) 。

GatewayDatasources

Power BI 网关数据源集合的 OData 响应包装器

名称	类型	说明
odata.context	string	OData 上下文
value	GatewayDatasource[]	网关数据源列表