List Device Current Firmware

罗列某产品下所有设备的固件版本。

操作权限

需授权的资源

所需操作权限

设备管理

Read

请求格式

GET https://{apigw-address}/connect-service/v2.1/ota-firmwares?action=listVersion

请求参数(URI)

名称

位置(Path/Query)

必需/可选

数据类型

描述

orgId

Query

必需

String

资产所属的组织ID。如何获取orgId信息>>

productKey

Query

必需

String

产品的Product key。

响应参数

名称

数据类型

描述

data

String Array

固件版本号列表。

错误码

有关错误码的描述,参见 通用错误码

示例

请求示例

url: https://{apigw-address}/connect-service/v2.1/ota-firmwares?action=listVersion&orgId=yourOrgId&productKey=yourProductKey
method: GET

返回示例

{
    "code": 0,
    "msg": "OK",
    "requestId": "59b92d01-1b8b-44a4-8e6a-01f7d9d256f2",
    "data": [
        "7.7",
        "2.0",
        "7777",
        "AOTA"
    ]
}

Java SDK调用示例

package com.envisioniot.enos.connect_service.ota.firmware;

import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envisioniot.enos.connect_service.v2_1.ota.firmware.ListDeviceCurrentFirmwaresRequest;
import com.envisioniot.enos.connect_service.v2_1.ota.firmware.ListDeviceCurrentFirmwaresResponse;

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

        String orgId = "yourOrgId";
        String productKey = "yourProductKey";

        ListDeviceCurrentFirmwaresRequest request = new ListDeviceCurrentFirmwaresRequest();
        request.setOrgId(orgId);
        request.setProductKey(productKey);

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