下载
中文
注册

文件上传

命令功能

通过接口进行文件上传,上传成功后文件被统一放在“/run/web”目录下。
  • zip文件放在“/run/web/zip”目录下。
  • crl,cer,crt文件放在“/run/web/cert”目录下。
  • conf文件放在“/run/web/conf”目录下。
  • ini文件放在“/run/web/ini”目录下。

命令格式

操作类型:POST

URLhttps://device_ip/redfish/v1/UpdateService/FirmwareInventory

请求头:

X-Auth-Token: auth_value

请求消息体:

{
    "imgfile": imgfile,
    "size": size
}

请求消息

表1 请求参数

参数名

是否必选

参数说明

取值要求

imgfile

必选

传输文件名称。通过Form-Data传输。

上传文件的文件名需要满足长度为1~255个字符,由大小写字母(a~z、A~Z)、数字(0~9)和其他字符(_.-)组成,且不能包含连续两个点(..)。

支持的文件类型如下:
  • zip
  • cer
  • crl
  • crt
  • conf
  • ini

当KEY的值是imgfile时,对应VALUE的值选择对应文件。

size

可选

上传文件大小。通过Form-Data传输。

取值为数字,支持的取值大小如下。
  • zip:文件大小需小于512MB。
  • cer,crl,crt,ini:最大支持10KB。
  • conf:最大支持20M。

使用指南

使用实例

请求样例:

POST https://10.10.10.10/redfish/v1/UpdateService/FirmwareInventory

请求头:

X-Auth-Token: auth_value 
请求消息体:
{
    "imgfile": 4.conf,
    "size": 202
}
响应样例:
{
    "message": "Upload [4.conf] file successfully.",
    "status": 202
}

响应码:202

输出说明

表2 操作输出说明

字段

类型

说明

status

数字

请求返回码。

message

字符串

详细信息。