V2.5 Report Device Firmware Version¶
上报设备固件版本。
操作权限¶
使用此 API 前，确保服务账号已被授予包含下列服务和操作权限的策略。有关授权服务账号的更多信息，参见 管理服务账号。
需授权的服务 |
所需操作权限 |
|---|---|
设备管理 |
Full Access |
请求格式¶
GET https://{apigw-address}/connect-service/v2.5/devices?action=reportFirmwareVersion
请求参数（URI）¶
名称 |
位置（Path/Query） |
必需/可选 |
数据类型 |
描述 |
|---|---|---|---|---|
orgId |
Query |
必需 |
String |
资产所属的组织 ID。如何获取 orgId 信息>> |
请求参数（Body）¶
名称 |
必需/可选 |
数据类型 |
描述 |
|---|---|---|---|
version |
必需 |
String |
固件版本号。前往 OTA 升级 > 固件管理 中 版本号 列查看固件版本号。 |
assetId |
必需 |
String |
资产ID。如何获取 assetId 信息>> |
productKey |
必需 |
String |
设备的 product key。如何获取设备的 productKey 信息>> |
deviceKey |
必需 |
String |
Device Key。如何获取设备的 deviceKey 信息>> |
响应参数¶
名称 |
数据类型 |
描述 |
|---|---|---|
code |
number |
更新成功或失败的指示码。 |
msg |
String |
成功时返回 |
requestId |
String |
每次请求获取的 ID，用于唯一标识一次 API 请求。 |
错误码¶
代码 |
错误信息 |
描述 |
|---|---|---|
400 |
Invalid Argument |
参数错误。 |
500 |
OTA Service Internal Error |
OTA 服务内部错误。 |
404 |
Device Not Found |
设备未找到。 |
示例¶
请求示例¶
url: https://{apigw-address}/connect-service/v2.5/devices?action=reportFirmwareVersion&orgId=yourOrgId
method: POST
返回示例¶
{
"code": 0,
"msg": "OK",
"requestId": "151ddb7a-6352-4069-9ef9-a7eb940c99eb",
"data": null
}