DigitalWarranty
更新时间： 2026/06/26
在Gitcode上查看源码ResourceDefinition
uris
/redfish/v1/Chassis/chassis_id/Oem/Public/DigitalWarranty
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 指定存储资源模型的OData描述信息 |
| @odata.id | string | true | - | 指定存储资源的访问路径 |
| @odata.type | string | true | - | 指定存储资源的类型 |
| Id | string | true | - | 资源ID |
| Name | string | true | - | 资源名称 |
| Description | string | true | - | 资源描述 |
| ProductName | string | true | - | 产品名称，如2288H V5 |
| SerialNumber | string | true | - | 产品域序列号 |
| ManufactureDate | string | true | - | 生产日期 |
| UUID | string | true | - | 设备对应的全局唯一标识符 |
| UnitType | string | true | - | 固定为“Device” |
| StartPoint | string | false | - | 服务起始时间 |
| Lifespan | number | false | - | 服务年限 取值：1~255 单位：月 |
| FirstPowerOnTime | string | true | - | 首次上电时间 格式为:YYYY-MM-DD |
supported_methods
- GET
- PATCH
HTTP methods
GET
命令功能
查询电子保单信息
命令格式
URL: https://device_ip/redfish/v1/Chassis/chassis_id/Oem/Public/DigitalWarranty
请求头:
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| chassis_id | 机箱资源的ID | ● 针对机架服务器，取值 为1 ● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1” ● 针对刀片服务器，取值 可以为BladeN（N表示 计算节点槽位号）或 SwiN（N表示交换模块 槽位号），例如 “Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以 为Enc，表示计算节点 所在的机框资源 ● 针对设备U位信息，取 值可以为UN(N表示设 备U位号)，例如"U1" ● 针对机柜资源，取值为 Rack |
| auth_value | 执行该GET请求时，必须 在“Headers”中携带“X- Auth-Token”值用于鉴权 | 表1 可通过/redfish/v1/ SessionService/Sessions 创建会话时获得 |
使用指南
BMC500 5.13.0.1及以上版本支持
使用实例
请求样例：
http
GET https://device_ip/redfish/v1/Chassis/1/Oem/Public/DigitalWarranty请求头：
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#HwDigitalWarranty.HwDigitalWarranty",
"@odata.id": "/redfish/v1/Chassis/1/Oem/Public/DigitalWarranty",
"@odata.type": "#HwDigitalWarranty.v1_0_0.HwDigitalWarranty",
"Description": "Digital Warranty",
"Name": "DigitalWarranty",
"Id": "DigitalWarranty",
"ProductName": "2288hv5",
"SerialNumber": "123456",
"ManufactureDate": "2020-01-15T21:29:40",
"UUID": "AC640AE7-0018-8549-B211-D21D2489633C",
"UnitType": "Device",
"StartPoint": "2020-04-15",
"Lifespan": 10,
"FirstPowerOnTime": "2020-01-01"
}响应码：200
PATCH
命令功能
修改电子保单信息
命令格式
URL: https://device_ip/redfish/v1/Chassis/chassis_id/Oem/Public/DigitalWarranty
请求头:
X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value请求消息体:
json
{
"StartPoint": SP_value,
"Lifespan": Lifespan_value
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| chassis_id | 机箱资源的ID | ● 针对机架服务器，取值 为1 ● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1” ● 针对刀片服务器，取值 可以为BladeN（N表示 计算节点槽位号）或 SwiN（N表示交换模块 槽位号），例如 “Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以 为Enc，表示计算节点 所在的机框资源 ● 针对设备U位信息，取 值可以为UN(N表示设 备U位号)，例如"U1" ● 针对机柜资源，取值为 Rack |
| SP_value | 服务起始时间 | 字符串 格式要求xxxx-xx-xx |
| Lifespan_value | 服务年限 | 0：表示清除当前维保信 息，该属性值响应为null 1~255：服务年限，单位 月 |
使用指南
BMC500 5.13.0.1及以上版本支持
使用实例
请求样例：
http
PATCH https://device_ip/redfish/v1/Chassis/1/Oem/Public/DigitalWarranty请求头：
X-Auth-Token: 123456789***********************
Content-Type: application/json
If-Match: W/"3d607e36"请求消息体：
json
{
"StartPoint": "2020-04-15",
"Lifespan": 10
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#HwDigitalWarranty.HwDigitalWarranty",
"@odata.id": "/redfish/v1/Chassis/1/Oem/Public/DigitalWarranty",
"@odata.type": "#HwDigitalWarranty.v1_0_0.HwDigitalWarranty",
"Description": "Digital Warranty",
"Name": "DigitalWarranty",
"Id": "DigitalWarranty",
"ProductName": "2288hv5",
"SerialNumber": "123456",
"ManufactureDate": "2020-01-15T21:29:40",
"UUID": "AC640AE7-0018-8549-B211-D21D2489633C",
"StartPoint": "2020-04-15",
"Lifespan": 10,
"FirstPowerOnTime": "2020-04-15"
}响应码：200