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 固件版本号。
assetId 必需 String 资产ID。
productKey 必需 String 设备的 product key。
deviceKey 必需 String Device Key。

响应参数

名称 数据类型 描述
code number 更新成功或失败的指示码。
msg String 成功时返回 OK；其他值则为失败。
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
}