通过ModifyOTAFirmware更新设备的OTA升级包_云市场(Marketplace)-阿里云帮助中心

ModifyOTAFirmware

更新设备的OTA升级包，包括升级包名称、升级包描述和自定义信息。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyOTAFirmware	系统规定参数。取值：ModifyOTAFirmware。
FirmwareId	String	是	127	OTA升级包ID，OTA升级包的唯一标识符。
FirmwareName	String	是	Firmware2	OTA升级包名称，创建后不可修改。支持中文、英文字母、日文、数字、短划线（-）、下划线（_）和半角圆括号（()），必须以中文、英文、日文或数字开头，长度限制为1~40个字符。
ProductKey	String	否	a1uctKe****	OTA升级包所属产品的ProductKey。
FirmwareDesc	String	否	OTA function updated	OTA升级包描述。长度不可超过100个字符。一个中文汉字算一个字符。
Udi	String	否	{"ota_notice":"升级底层摄像头驱动，解决视频图像模糊的问题。"}	推送给设备的自定义信息。不限制文本内容格式，长度不超过4096个字符。添加该升级包完成，并创建升级任务后，物联网平台向设备推送升级通知时，会将该自定义信息下发给设备。

重要

‼️ 注意：调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数。

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。更多信息，请参见错误码。
ErrorMessage	String	系统异常	调用失败时，返回的出错信息。
RequestId	String	291438BA-6E10-4C4C-B761-243B9A0D324F	物联网平台为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功，表示OTA升级包创建成功。 false：调用失败，表示OTA升级包创建失败。

示例

请求示例

curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=ModifyOTAFirmware&SignatureNonce=9e6189124f5a4716ad2de849467b****&AccessKeyId=xMr9wgwXQLhv5AUa65o0****&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T09%3A47%3A43Z&ProductKey=a1uctKe****&FirmwareName=Firmware2&DestVersion=1.9.9&FirmwareId=165&FirmwareDesc=modifyfirmware&Signature=WJN0Ee8%2BX6pogcD3loLHIqQNEN0%3D'

正常返回示例

{
    "code": "",
    "requestId": "d2fce065-8238-4ee2-a793-0226f69b0542",
    "success": true
}