V2.1 List Device Current Firmware¶

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

该 API 支持在 EnOS 2.2.0 及以上环境中使用。

操作权限¶

使用此 API 前，确保服务账号已被授予包含下列服务和操作权限的策略。有关授权服务账号的更多信息，参见管理服务账号。

需授权的服务	所需操作权限
固件	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。如何获取 productKey 信息>>

响应参数¶

名称	数据类型	描述
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"
    ]
}

SDK 示例¶

你可以在 Github 上获取接入服务的 SDK 示例：

Java
Python