升级固件

命令功能

升级固件。

命令格式

操作类型：POST

URL：https://device_ip/redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate

请求头：

X-Auth-Token: auth_value

Content-Type: header_type

请求消息体：

    "ImageURI": filename,

    "TransferProtocol": protocol

请求参数

表1 请求参数
参数名	是否必选	参数说明	取值
ImageURI	必选	升级包的名称	自定义软件包名称，具体名称由用户提供。字符串，文件名支持长度为1~255个字符，由大小写字母（a~z、A~Z）、数字（0~9）和其他字符（_.-）组成，且不能包含..
TransferProtocol	必选	上传升级包时使用的协议	https

使用指南

无

使用实例

请求样例：

POST https://10.10.10.10/redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate

请求头：

X-Auth-Token: auth_value

Content-Type: application/json

请求消息体：

{
    "ImageURI":"xxx_{_Version}_linux-aarch64.zip",
    "TransferProtocol":"https"
}

响应样例：

{
    "@odata.context": "/redfish/v1/$metadata#TaskService/Tasks/Members/$entity",
    "@odata.type": "#Task.v1_0_2.Task",
    "@odata.id": "/redfish/v1/TaskService/Tasks/1",
    "Id": "1",
    "Name": "Upgarde Task",
    "TaskState": "Running",
    "StartTime": "2023-03-26 14:35:34",
    "Messages": [{
        "upgradeState": "Running"
    }],
    "PercentComplete": 0,
    "Module": "",
    "Version": ""
}

响应码：202

输出说明

表2 操作输出说明
字段	类型	说明
@odata.context	字符串	升级任务资源模型的OData描述信息。
@odata.type	字符串	升级任务资源的类型。
@odata.id	字符串	当前升级资源的任务描述。
Id	数字	升级任务资源的ID。
Name	字符串	升级任务资源的名称。
TaskState	字符串	升级任务资源的状态。 New Starting Running Failed
StartTime	字符串	升级任务的起始时间。
Messages	对象	升级任务的相关信息。
Messages.upgradeState	字符串	升级任务状态详细描述
PercentComplete	数字	升级进度。
Module	字符串	固件类型。
Version	字符串	升级包版本。

父主题： 软件管理