修改系统资源属性
命令功能
修改当前系统资源属性。
命令格式
操作类型: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 |
对象 |
远程恢复出厂设置操作。 |