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”。 | ||||||
@Redfish.OperationApplyTimeSupport | 对象 | 已展开 | ||||||
SupportedValues | 数组 | 项：字符串 项数：3 | ||||||
SupportedValues[N] | 字符串 | “Immediate” “OnReset” “OnStartUpdateRequest” | ||||||
HttpPushUri | 链接 | 用于对更新服务执行 HTTP 或 HTTPS 推送更新的 URI。值为“/fwupdate”。 | ||||||
HttpPushUriTargets | 数组 | 项：字符串 项数：0-1 | ||||||
HttpPushUriTargets[N] | 字符串 | 指示将更新映像应用到何处的 URI 数组。此值最初为空白，并且在 XCC2 重置后不会保留客户端更新的值。 | ||||||
HttpPushUriTargetsBusy | 布尔 | 指示是否有任何客户端保留了 HttpPushUriTargets 属性。此值最初为 false，并且在 XCC2 重置后不保留。 | ||||||
HttpPushUriOptions | 对象 | 已展开 | ||||||
HttpPushUriApplyTime | 对象 | 已展开 | ||||||
ApplyTime | 字符串 | “Immediate” | ||||||
ApplyTime@Redfish.AllowableValues | 数组 | 项：字符串 项数：2 | ||||||
ApplyTime@Redfish.AllowableValues[N] | 字符串 | “Immediate” “OnReset” | ||||||
FirmwareInventory | 对象 | 服务器上的固件信息的 URI | ||||||
MultipartHttpPushUri | 字符串 | 用于通过分段式请求正文对服务执行 HTTPS 推送更新的 URI；值为“/mfwupdate”。 | ||||||
MultipartHttpPushUri@Redfish.OperationApplyTimeSupport | 对象 | 已展开 | ||||||
SupportedValues | 数组 | 项：字符串 项数：3 | ||||||
SupportedValues[N] | 字符串 | “Immediate” “OnReset” “OnStartUpdateRequest” | ||||||
MaxImageSizeBytes | 整数 | 250000000 | ||||||
RemoteServerCertificates | 链接 | CertificateCollection 集合的链接。 | ||||||
VerifyRemoteServerCertificate | 布尔 | 指示在发送传输请求之前此服务是否会验证 SimpleUpdate 中 ImageURI 属性引用的 HTTPS 服务器的证书。 默认值为 false。 | ||||||
状态代码
| HTTP 状态代码 | 错误消息 ID |
|---|---|
| 500 | InternalError |
示例
返回以下示例 JSON 响应：
{
"RemoteServerCertificates": {
"@odata.id": "/redfish/v1/UpdateService/RemoteServerCertificates"
},
"HttpPushUriTargets": [],
"FirmwareInventory": {
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory"
},
"ServiceEnabled": true,
"MultipartHttpPushUri@Redfish.OperationApplyTimeSupport": {
"@odata.type": "#Settings.v1_3_4.OperationApplyTimeSupport",
"SupportedValues": [
"Immediate",
"OnReset",
"OnStartUpdateRequest"
]
},
"@odata.type": "#UpdateService.v1_11_0.UpdateService",
"@odata.id": "/redfish/v1/UpdateService",
"Actions": {
"#UpdateService.SimpleUpdate": {
"target": "/redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate",
"title": "SimpleUpdate",
"Targets@Redfish.AllowableValues": [
"/redfish/v1/UpdateService/FirmwareInventory/BMC-Backup"
],
"TransferProtocol@Redfish.AllowableValues": [
"TFTP",
"SFTP",
"HTTPS",
"HTTP"
],
"@Redfish.ActionInfo": "/redfish/v1/UpdateService/SimpleUpdateActionInfo",
"@Redfish.OperationApplyTimeSupport": {
"@odata.type": "#Settings.v1_3_4.OperationApplyTimeSupport",
"SupportedValues": [
"Immediate",
"OnReset",
"OnStartUpdateRequest"
]
}
},
"Oem": {
"#LenovoUpdateService.BundleRollback": {
"target": "/redfish/v1/UpdateService/Actions/Oem/LenovoUpdateService.BundleRollback",
"title": "BundleRollback"
},
"#LenovoUpdateService.UpdateFromRepository": {
"target": "/redfish/v1/UpdateService/Actions/Oem/LenovoUpdateService.UpdateFromRepository",
"title": "UpdateFromRepository"
},
"#LenovoUpdateService.GetRepoUpdateDetail": {
"target": "/redfish/v1/UpdateService/Actions/Oem/LenovoUpdateService.GetRepoUpdateDetail",
"title": "GetRepoUpdateDetail"
}
},
"#UpdateService.StartUpdate": {
"target": "/redfish/v1/UpdateService/Actions/UpdateService.StartUpdate",
"title": "StartUpdate",
"@Redfish.ActionInfo": "/redfish/v1/UpdateService/StartUpdateActionInfo"
}
},
"MaxImageSizeBytes": 250000000,
"HttpPushUriOptions": {
"HttpPushUriApplyTime": {
"ApplyTime": "Immediate",
"ApplyTime@Redfish.AllowableValues": [
"Immediate",
"OnReset"
]
}
},
"@odata.etag": "\"12fc6cd9e7d7735944e43b\"",
"HttpPushUri": "/fwupdate",
"MultipartHttpPushUri": "/mfwupdate",
"Description": "Lenovo firmware update service.",
"HttpPushUriTargetsBusy": false,
"Name": "Update Service",
"Oem": {
"Lenovo": {
"BundleRepoAvailableSpaceInKB": 2004634,
"FirmwareServices": {
"@odata.id": "/redfish/v1/UpdateService/Oem/Lenovo/FirmwareServices"
},
"@odata.type": "#LenovoUpdateService.v1_0_0.LenovoUpdateService"
}
},
"VerifyRemoteServerCertificate": false,
"@odata.context": "/redfish/v1/$metadata#UpdateService.UpdateService",
"Status": {
"HealthRollup": "OK",
"State": "Enabled",
"Health": "OK"
},
"Id": "UpdateService"
}