跳到主要内容

GET – 固件更新服务的属性

使用 GET 方法检索 Redfish 服务的更新服务资源。

请求 URL

GET https://<BMC_IPADDR>/redfish/v1/UpdateService

响应正文

字段类型描述

Id

字符串

“UpdateService”

Name

字符串

“Update Service”

Description

字符串

“Lenovo firmware update service.”

ServiceEnabled

布尔

True。

Status

对象

已展开。

 

HealthRollup

字符串

“OK”。

 

Health

字符串

“OK”。

 

State

字符串

“Enabled”。

Actions

对象

已展开。

 

#UpdateService.SimpleUpdate

对象

已展开。

  

@Redfish.ActionInfo

链接

“/redfish/v1/UpdateService/SimpleUpdateActionInfo”

  

target

字符串

相关操作的链接。

  

title

字符串

“SimpleUpdate”。

  

Targets@Redfish.AllowableValues

链接

“/redfish/v1/UpdateService/FirmwareInventory/BMC-Backup”

  

TransferProtocol @Redfish.AllowableValues

数组

SimpleUpdate 操作的允许值

项:字符串

项数:2

  

TransferProtocol @Redfish.AllowableValues[N]

字符串

“SFTP”。

“TFTP”。

HttpPushUri

链接

用于对更新服务执行 HTTP 或 HTTPS 推送更新的 URI。值为“/fwupdate”。

HttpPushUriTargets

数组

项:字符串

项数:0-1

 

HttpPushUriTargets[N]

字符串

指示将更新映像应用到何处的 URI 数组。此值最初为空白,并且在 XCC 重置后不会保留客户端更新的值。

HttpPushUriTargetsBusy

布尔

指示是否有任何客户端保留了 HttpPushUriTargets 属性。此值最初为 false,并且在 XCC 重置后不保留。

HttpPushUriOptions

对象

已展开

 

HttpPushUriApplyTime

对象

已展开

  

ApplyTime

字符串

“Immediate”

FirmwareInventory

对象

服务器上的固件信息的 URI

MultipartHttpPushUri

字符串

用于通过分段式请求正文对服务执行 HTTPS 推送更新的 URI;值为“/mfwupdate”。

MaxImageSizeBytes

整数

250000000

状态代码

HTTP 状态代码错误消息 ID
500InternalError

示例

返回以下示例 JSON 响应:

{
"MultipartHttpPushUri": "/mfwupdate",
"Id": "UpdateService",
"ServiceEnabled": true,
"HttpPushUri": "/fwupdate",
"HttpPushUriTargets": [],
"Description": "Lenovo firmware update service.",
"FirmwareInventory": {
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory"
},
"Status": {
"HealthRollup": "OK",
"Health": "OK",
"State": "Enabled"
},
"Name": "Update Service",
"HttpPushUriTargetsBusy": false,
"Oem": {
"Lenovo": {
"FirmwareServices": {
"@odata.id": "/redfish/v1/UpdateService/Oem/Lenovo/FirmwareServices"
},
"@odata.type": "#LenovoUpdateService.v1_0_0.LenovoUpdateService"
}
},
"@odata.type": "#UpdateService.v1_6_0.UpdateService",
"Actions": {
"#UpdateService.SimpleUpdate": {
"target": "/redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate",
"title": "SimpleUpdate",
"TransferProtocol@Redfish.AllowableValues": [
"TFTP",
"SFTP"
],
"Targets@Redfish.AllowableValues": [
"/redfish/v1/UpdateService/FirmwareInventory/BMC-Backup"
],
"@Redfish.ActionInfo": "/redfish/v1/UpdateService/SimpleUpdateActionInfo"
}
},
"MaxImageSizeBytes": 250000000,
"@odata.etag": "\"593b8fa08d40fe0001e39baf3ac3094a\"",
"HttpPushUriOptions": {
"HttpPushUriApplyTime": {
"ApplyTime": "Immediate"
}
},
"@odata.id": "/redfish/v1/UpdateService"
}