uploadFirmware接口
上传设备固件到云平台上，上传文件格式为.mwf。
仅管理员有权限。
上传固件成功后，需要再执行add-firmware接口使固件生效，固件生效后才能被审核通过的同类型设备使用。
接口原型
| 协议 |
HTTP/HTTPS POST |
| URL |
ip[:port]/sc_cloud/uploadFirmware |
| 数据格式 |
请求消息：Content-Type: multipart/form-data; boundary=xxx
响应消息：Content-Type: application/json |
请求Cookies
| 名称 |
描述 |
| mwcloud-sid |
用于标识当前登录的字符串 |
| mwcloud-uid |
当前登录用户名 |
Request Body
设备固件文件。
请求示例
POST /sc_cloud/uploadFirmware HTTP/1.1
Content-Type: multipart/form-data; boundary=---------------------------42288931224667793852045763104
Content-Length: 14556621
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
-----------------------------42288931224667793852045763104
Content-Disposition: form-data; name="file"; filename="ultra_stream_sdi_rev_a_1_5_79.mwf"
Content-Type: application/octet-stream
...
-----------------------------42288931224667793852045763104--
响应参数
| 参数 |
描述 |
| Content-Type |
取值为：'application/json; charset=UTF-8' |
Response Body
| 参数 |
描述 |
| result |
返回码。 |
| file-path |
文件路径。 |
| file-size |
文件大小。 |
| firmware-info |
上传的设备固件基本信息。 |
firmware-info
| 参数 |
描述 |
| product-id |
产品编号。 |
| firmware-id |
固件版本类型。 |
| marjor-ver |
主版本号。 |
| minor-ver |
次版本号。 |
| build-number |
构建号。 |
| build-time |
构建时间。 |
| product-name |
产品型号。 |
| hardware-ver |
硬件版本。 |
固件版本号由marjor-ver、minor-ver和build-number组成。
如响应示例中固件版本为1.5.79。
响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 285
{
"result": 0，
"file-path": "/data/new-firmware-6.mwf",
"file-size": 14556364,
"firmware-info": {
"product-id": 770,
"firmware-id": 0,
"marjor-ver": 1,
"minor-ver": 5,
"build-number": 79,
"build-time": "2021-05-13 05:27:59",
"product-name": "Ultra Stream SDI",
"firmware-name": "Standard",
"hardware-ver": "A"
}
}