Datasets - Get Gateway Datasources

服务:

Power BI REST APIs

API 版本:

v1.0

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

重要

此 API 调用已弃用，请改用 获取数据源。

所需范围

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

示例请求

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

示例响应

状态代码:

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
Basic
Key
OAuth2
SAS
Windows

GatewayDatasource

Object

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 交流 扩展 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)	关联的网关 ID。 使用网关群集时，网关 ID 引用群集中的主网关（第一个）网关，类似于网关群集 ID。
id	string (uuid)	数据源的唯一 ID

GatewayDatasourceCredentialDetails

Object

数据源凭据详细信息

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

GatewayDatasources

Object

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

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