Datasets - Discover Gateways In Group

参考

Service:: Power BI REST APIs

API Version:: v1.0

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

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

权限

此 API 调用可由服务主体配置文件调用。有关详细信息，请参阅：Power BI Embedded中的服务主体配置文件。

所需范围

Dataset.Read.All

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

URI 参数

名称	在	必需	类型	说明
datasetId	path	True	string	数据集 ID
groupId	path	True	string uuid	工作区 ID

响应

名称	类型	说明
200 OK	Gateways	确定

示例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.DiscoverGateways

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
      "name": "My_Sample_Gateway",
      "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[]	网关列表

通过