Get Firmware File¶

获取指定固件版本号的固件详情。

操作权限¶

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

请求格式¶

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

请求参数（URI）¶

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

响应参数¶

名称	数据类型	描述
data	FirmwareInfo结构体	固件详情。FirmwareInfo结构体的结构参见下表。

FirmwareInfo结构体 ¶

名称	数据类型	描述
orgId	String	资产所属的组织ID。
firmwareId	String	固件ID。
productKey	String	设备的Product key。
name	StringI18n	固件名称。
version	String	固件版本号。
desc	String	固件描述。
signMethod	String	固件文件签名算法。
sign	String	固件文件签名。
fileUrl	String	固件文件标识符。
fileSize	String	固件文件大小。
enableVerification	Boolean	固件用于升级任务时是否必须验证过。
isVerified	Boolean	固件是否经过验证。
createTime	Long	固件创建时间。

错误码¶

代码	错误信息	描述
24404	Firmware not found	找不到固件。

示例¶

请求示例¶

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

返回示例¶

{
        "code":0,
        "msg":"OK",
        "requestId":"28da9093-400f-4eb1-8cdc-83e4ec77070d",
        "data":{
                "orgId":"yourOrgId",
                "firmwareId":"yourFirmwareId",
                "productKey":"BXwU4kMk",
                "name":{
                        "defaultValue":"HC_TEST",
                        "i18nValue":{

                        }
                },
                "version":"2.0",
                "desc":null,
                "signMethod":"md5",
                "sign":"12c696fa5c075e8687458fd6ce164b57",
                "fileUrl":"enos-connect://2325a9b338800000.zip",
                "fileSize":1767,
                "isVerified":false,
                "enableVerification":false,
                "createTime":1590746442378
        }
}

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.GetFirmwareFileRequest;
import com.envisioniot.enos.connect_service.v2_1.ota.firmware.GetFirmwareFileResponse;

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

        String orgId = "yourOrgId";
        String firmwareId = "yourFirmwareId";

        GetFirmwareFileRequest request = new GetFirmwareFileRequest();
        request.setOrgId(orgId);
        request.setFirmwareId(firmwareId);

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