下载
中文
注册

修改系统资源属性

命令功能

修改当前系统资源属性。

命令格式

操作类型:PATCH

URLhttps://device_ip/redfish/v1/Systems

请求头:

X-Auth-Token: auth_value
Content-Type: header_type

请求消息体:

{
    "AssetTag": tag,
    "DateTime": time,
    "DateTimeLocalOffset": offset,
    "HostName": hostname
}

请求参数

表1 请求参数

参数名

是否必选

参数说明

取值

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

输出说明

表2 操作输出说明

字段

类型

说明

@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

对象

远程恢复出厂设置操作。