Datasets - Discover Gateways

Service:

Power BI REST APIs

API Version:

v1.0

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

此 API 调用仅与具有至少一个本地连接的数据集相关。 对于具有仅限云连接的数据集，此 API 调用返回空列表。

所需范围

Dataset.Read.All

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

URI 参数

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

响应

名称	类型	说明
200 OK	Gateways	确定

示例

Example

Sample Request

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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "ContosoGateway",
      "type": "Resource",
      "publicKey": {
        "exponent": "AQAB",
        "modulus": "o6j2....cLk="
      }
    }
  ]
}

定义

名称	说明
Gateway	Power BI 网关
GatewayPublicKey	Power BI 网关公钥
Gateways	Power BI 网关列表的 OData 响应包装器

Gateway

Power BI 网关

名称	类型	说明
gatewayAnnotation	string	JSON 格式的网关元数据
gatewayStatus	string	网关连接状态
id	string	网关 ID。 使用网关群集时，网关 ID 是指群集中第一个) 网关的主 (，类似于网关群集 ID。
name	string	网关名称
publicKey	GatewayPublicKey	网关公钥
type	string	网关类型

GatewayPublicKey

Power BI 网关公钥

名称	类型	说明
exponent	string	公钥指数
modulus	string	公钥模数

Gateways

Power BI 网关列表的 OData 响应包装器

名称	类型	说明
odata.context	string
value	Gateway[]	网关列表