修改系统资源属性
命令功能
修改当前系统资源属性。
命令格式
操作类型:PATCH
URL:https://device_ip/redfish/v1/Systems
请求头:
X-Auth-Token: auth_value
Content-Type: header_type
请求消息体:
{
"AssetTag": tag,
"DateTime": time,
"DateTimeLocalOffset": offset,
"HostName": hostname
}
请求参数
参数名 |
是否必选 |
参数说明 |
取值 |
|---|---|---|---|
AssetTag |
可选 |
自定义的资产标签。 |
取值范围为1~255位的字符串。 可由数字、英文字母和英文标点符号等组成(即ASCII码值从0x20~0x7E的字符)。 |
DateTime |
可选 |
系统当前时间。 |
字符串。长度为10~64字符,时间格式:%Y-%m-%d %H:%M:%S或者是%Y-%m-%d。 说明:
系统支持设置的时间范围为Linux系统支持的时间范围。 |
DateTimeLocalOffset |
可选 |
系统时间时区。 |
字符串。长度为0~100可由大小写字母(a~z、A~Z)、数字(0~9)和其他字符(+-/:_)组成且不含“..”。 |
HostName |
可选 |
系统主机名称。 |
取值范围为1~63位的字符串。 可由数字(0~9)、英文字母(a~z、A~Z)和连字符(-)组成,且连字符不能出现在开头和结尾。 |
使用指南
无
使用实例
请求样例:
PATCH https://10.10.10.10/redfish/v1/Systems
请求头:
X-Auth-Token: auth_value
Content-Type: application/json
请求消息体:
{
"AssetTag": "test00",
"DateTime": "2022-05-13 15:36:10",
"DateTimeLocalOffset": "UTC",
"HostName": "Atlas 200I A2"
}
响应样例:
{
"@odata.context": "/redfish/v1/$metadata#Systems",
"@odata.id": "/redfish/v1/Systems",
"@odata.type": "#ComputerSystem.v1_18_0.ComputerSystem",
"Id": "1",
"Name": "Computer System",
"HostName": "Atlas 200 A2",
"UUID": "025VLB10K6000019",
"Model": "Atlas 200 A2",
"SupportModel": "Atlas 200 DK A2",
"SerialNumber": "2102312NNU10K7000017",
"AssetTag": "test00",
"Status": {
"Health": "OK"
},
"Processors": {
"@odata.id": "/redfish/v1/Systems/Processors"
},
"Memory": {
"@odata.id": "/redfish/v1/Systems/Memory"
},
"EthernetInterfaces": {
"@odata.id": "/redfish/v1/Systems/EthernetInterfaces"
},
"LogServices": {
"@odata.id": "/redfish/v1/Systems/LogServices"
},
"SimpleStorages": {
"@odata.id": "/redfish/v1/Systems/SimpleStorages"
},
"Oem": {
"PCBVersion": 1,
"Temperature": 50,
"Power": 23,
"Voltage": 0.02,
"CpuHeating": "Stop",
"DiskHeating": "Stop",
"UsbHubHeating": "Heating",
"AiTemperature": 55,
"SoftwareVersion": "22.0.3",
"ProcessorArchitecture": "ARM",
"OSVersion": "EulerOS 2.0 (SP10)",
"KernelVersion": "4.19.90",
"Uptime": "06:56:58 up 6 min",
"Datetime": "Fri May 13 15:36:17 UTC 2022",
"DateTimeLocalOffset": "UTC (UTC, +0000)",
"CpuUsage": 9.09,
"MemoryUsage": 16.31,
"Firmware": [
{
"Version": "3.0",
"InactiveVersion": "3.0",
"Module": "Ascend-firmware",
"BoardId": "",
"UpgradeResult": false,
"UpgradeProcess": 0
}
],
"InactiveFirmware": [],
"InactiveConfiguration": null,
"NTPService": {
"@odata.id": "/redfish/v1/Systems/NTPService"
},
"ExtendedDevices": {
"@odata.id": "/redfish/v1/Systems/ExtendedDevices"
},
"LTE": {
"@odata.id": "/redfish/v1/Systems/LTE"
},
"NfsManage": {
"@odata.id": "/redfish/v1/Systems/NfsManage"
},
"SecurityService": {
"@odata.id": "/redfish/v1/Systems/SecurityService"
},
"Alarm": {
"@odata.id": "/redfish/v1/Systems/Alarm"
},
"SystemTime": {
"@odata.id": "/redfish/v1/Systems/SystemTime"
},
"EthIpList": {
"@odata.id": "/redfish/v1/Systems/EthIpList"
},
"Modules": {
"@odata.id": "/redfish/v1/Systems/Module"
}
},
"Actions": {
"#ComputerSystem.Reset": {
"target": "/redfish/v1/Systems/Actions/ComputerSystem.Reset"
},
"Oem": {
"#ComputerSystem.RestoreDefaults": {
"target": "/redfish/v1/Systems/Actions/ComputerSystem.RestoreDefaults"
}
}
}
}
响应码:200
输出说明
字段 |
类型 |
说明 |
|---|---|---|
@odata.context |
字符串 |
指定系统资源模型的OData描述信息。 |
@odata.id |
字符串 |
指定系统资源的访问路径。 |
@odata.type |
字符串 |
指定系统资源的类型。 |
Id |
字符串 |
指定系统资源的ID。 |
Name |
字符串 |
指定系统资源的名称。 |
HostName |
字符串 |
系统主机名称。 |
UUID |
字符串 |
系统唯一标识。 |
Model |
字符串 |
产品名称。 |
SupportModel |
字符串 |
支持升级的产品名称。 |
SerialNumber |
字符串 |
产品序列号。 |
AssetTag |
字符串 |
用户定义电子标签。 |
Status |
对象 |
指定系统资源的状态。 Health:系统资源健康状态。 |
Processors |
对象 |
处理器接口资源的访问路径。 |
Memory |
对象 |
内存接口资源的访问路径。 |
EthernetInterfaces |
对象 |
以太网接口资源的访问路径。 |
LogServices |
对象 |
日志接口资源的访问路径。 |
SimpleStorage |
对象 |
简单存储接口资源的访问路径。 |
Oem |
对象 |
自定义属性。 |
PCBVersion |
数字 |
PCB版本号。 |
Temperature |
数字 |
系统温度。 |
Power |
数字 |
系统功率。 |
Voltage |
数字 |
系统电压。 |
CpuHeating |
字符串 |
CPU加热状态。 |
DiskHeating |
字符串 |
硬盘加热状态。 |
UsbHubHeating |
字符串 |
USB Hub加热状态。 |
AiTemperature |
数字 |
MiniD温度。 |
SoftwareVersion |
字符串 |
系统软件版本号。 |
ProcessorArchitecture |
字符串 |
处理器架构。 |
OSVersion |
字符串 |
操作系统版本。 |
KernelVersion |
字符串 |
内核版本号。 |
Uptime |
字符串 |
系统连续运行时间。 |
Datetime |
字符串 |
系统当前时间。 说明:
由于系统数据缓存,返回的时间与系统时间存在20秒左右的偏差。 |
DateTimeLocalOffset |
字符串 |
系统时间时区。 |
CpuUsage |
数字 |
CPU占用率百分比,取值范围为0~100。 |
MemoryUsage |
数字 |
内存占用率百分比,取值范围为0~100。 |
Firmware |
列表 |
固件列表。 取值为Ascend-firmware |
InactiveFirmware |
列表 |
未生效固件的名称。 如有多个未生效固件,则以逗号隔开。 |
InactiveConfiguration |
字符串 |
未生效的已导入的配置文件名称。 |
NTPService |
对象 |
NTPService接口资源的访问路径。 |
ExtendedDevices |
对象 |
外部设备接口资源的访问路径。 |
LTE |
对象 |
无线网络接口资源的访问路径。 |
Partitions |
对象 |
磁盘接口资源的访问路径。 |
NfsManage |
对象 |
NFS接口资源的访问路径。 |
SecurityService |
对象 |
安全服务接口资源的访问路径。 |
Alarm |
对象 |
告警接口资源的访问路径。 |
SystemTime |
对象 |
系统时间接口资源的访问路径。 |
EthIpList |
对象 |
获取网口与IP列表接口资源的访问路径。 |
Modules |
对象 |
外部设备模组接口资源的访问路径。 |
Actions |
对象 |
可执行操作。 |
#ComputerSystem.Reset |
对象 |
OS重启操作。 |
#ComputerSystem.RestoreDefaults |
对象 |
远程恢复出厂设置操作。 |