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 |
|---|---|
| 500 | InternalError |
示例
返回以下示例 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"
}