Get Gateway¶

获取子设备对应的网关信息。

操作权限¶

需授权的资源	所需操作权限
设备管理	Read

请求格式¶

POST https://{apigw-address}/connect-service/v2.1/device-topos?action=getGateway

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的组织ID。如何获取orgId信息>>

请求参数（Body）¶

名称	必需/可选	数据类型	描述
subDevice	必需	DeviceIdentifier结构体	识别子设备的标志信息，见 DeviceIdentifier结构体>>

DeviceIdentifier结构体¶

备注

以下非必须字段中，必须提供 assetId 或 productKey + deviceKey 的组合，用于指定设备。

名称	数据类型	描述
assetId	String	资产ID。如何获取Asset ID信息>>
productKey	String	Product Key.
deviceKey	String	Device Key.

响应参数¶

名称	数据类型	描述
data	Device结构体	网关设备信息，见 Device结构体>>

Device结构体¶

名称	数据类型	描述
orgId	String	资产所属的组织ID
assetId	String	资产ID
modelId	String	资产所属模型ID。
modelIdPath	String	模型ID的路径。
productKey	String	Product Key.
productName	StringI18n	产品名称。
productType	String	产品类型。
dataFormat	String	数据格式。Custom表示支持用户自定义数据格式，Json表示只支持EnOS设备协议格式。
deviceKey	String	Device Key.
deviceName	StringI18n	设备名称。
deviceSecret	String	设备的连接秘钥。
deviceDesc	String	设备描述。
timezone	String	设备所在时区。
deviceAttributes	Map（Key为String，Value为String）	设备的属性。
deviceTags	Map（Key为String，Value为String）	设备的标志。
createTime	Long	设备的创建时间。
status	String	设备的状态（online，offline，inactive或disable）。
activeTime	Long	设备的激活时间。
lastOnlineTime	Long	设备最后一次上线时间。
lastOfflineTime	Long	设备最后一次离线时间。
measurepointLastUpdate	Long	设备测点最近一次更新的时间。
eventLastUpdate	Long	设备事件最近一次更新的时间。
attributeLastUpdate	Long	设备属性最近一次更新的时间。
featureLastUpdate	Long	设备最近一次更新的时间，以上述三个时间（ `measurepointLastUpdate` 、 `eventLastUpdate` 、 `attributeLastUpdate` ）里最近的时间为准。

示例¶

请求示例¶

url: https://{apigw-address}/connect-service/v2.1/device-topos?action=getGateway&orgId=yourOrgId
method: POST
requestBody:
{
    "subDevice":{
        "assetId":"yourAssetId"
    }
}

返回示例¶

{
    "code": 0,
    "msg": "OK",
    "requestId": "49ef6c03-02a0-449b-ab1e-92812071de80",
    "data": {
        "orgId": "yourOrgId",
        "assetId": "J1Rqyaqz",
        "modelId": "AlterTest0617",
        "modelIdPath": "/AlterTest0617",
        "productKey": "yourProductKey",
        "productName": {
            "defaultValue": "testtopo",
            "i18nValue": {}
        },
        "productType": "Gateway",
        "dataFormat": "Json",
        "deviceKey": "yourDeviceKey",
        "deviceName": {
            "defaultValue": "testtopo",
            "i18nValue": {}
        },
        "deviceSecret": "yourDeviceSecret",
        "deviceDesc": null,
        "timezone": "+08:00",
        "deviceAttributes": {},
        "deviceTags": {},
        "createTime": 1560759829419,
        "status": "inactive",
        "activeTime": 0,
        "lastOnlineTime": 0,
        "lastOfflineTime": 0,
    "measurepointLastUpate": null,
    "eventLastUpdate": null,
    "attributeLastUpdate": 1561447707379,
    "featureLastUpdate": 1561447707379
    }
}

Java SDK调用示例¶

package com.envisioniot.enos.api.sample.connect_service.device.topo;

import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envisioniot.enos.connect_service.v2_1.device.topo.GetGatewayRequest;
import com.envisioniot.enos.connect_service.v2_1.device.topo.GetGatewayResponse;
import com.envisioniot.enos.connect_service.vo.DeviceIdentifier;


public class GetGateWay {
    public static void main(String[] args) {
        final String appKey = "yourAppKey";
        final String appSecret = "yourAppSecret";
        String serverUrl = "yourSeverUrl";

        String orgId = "yourOrgId";
        GetGatewayRequest request = new GetGatewayRequest();
        request.setOrgId(orgId);
        request.setSubDevice(new DeviceIdentifier("zGeKTDrw"));


        GetGatewayResponse response = Poseidon.config(PConfig.init().appKey(appKey).appSecret(appSecret).debug())
                .url(serverUrl)
                .getResponse(request, GetGatewayResponse.class);
    }}