ResourceDefinition

uris

/redfish/v1/Systems/system_id/Processors/cpu_id
/redfish/v1/Systems/system_id/Processors/processor_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	指定处理器资源模型的OData描述信息
@odata.id	string	true	-	指定处理器资源的访问路径
@odata.type	string	true	-	指定处理器资源的类型
Name	string	true	-	指定处理器资源的名称
Id	string	true	-	指定处理器在BMC系统中的唯一标识
ProcessorType	string	true	-	指定处理器资源的类型 ● CPU：CPU ● NPU：NPU ● GPU：GPU ● FPGA：FPGA ● DSP：DSP ● Accelerator：Accelerator ● OEM：OEM
ProcessorArchitecture	string	true	-	指定处理器资源的架构（CPU、NPU资源具有） ● x86：x86 ● IA-64：IA-64 ● ARM：ARM ● MIPS：MIPS ● OEM：OEM
InstructionSet	string	true	-	指定处理器资源的指令集（CPU、NPU资源具有） ● x86：x86 ● x86-64：x86-64 ● IA-64：IA-64 ● ARM-A32：ARM-A32 ● ARM-A64：ARM-A64 ● MIPS32：MIPS32 ● MIPS64：MIPS64 ● OEM：OEM
Manufacturer	string	true	-	指定处理器资源的制造商
Model	string	true	-	指定处理器资源的型号
ProcessorId {	object	true	-	处理器ID信息
ProcessorId.IdentificationRegisters	string	true	-	处理器的标识寄存器（仅CPU资源具有）
ProcessorId.EffectiveFamily	string	true	-	处理器的有效系列（仅CPU资源具有）
ProcessorId.EffectiveModel	string	true	-	处理器的有效型号（仅CPU资源具有）
ProcessorId.Step	string	true	-	处理器的步进（仅CPU资源具有）
}
MaxSpeedMHz	number	true	-	指定处理器资源的最大主频（仅CPU资源具有）
TotalCores	number	true	-	指定处理器资源的总核数（仅CPU资源具有）
TotalThreads	number	true	-	指定处理器资源的总线程数（仅CPU资源具有）
TotalEnabledCores	number	true	-	指定处理器资源的可用核数（仅CPU资源具有）
Socket	number	true	-	指定处理器资源的插槽号（仅CPU资源具有）
Links {	object	true	-	指定处理器资源的资源链接
`Links.PCIeFunctions[].@odata.id`	string	true	-	成员资源节点的访问路径
Links.PCIeDevice {	object	true	-	与此处理器关联的PCIe设备的链接（仅CPU资源具有）
`Links.PCIeDevice.@odata.id`	string	true	-	PCIeDevice资源的访问路径
}
Links.PCIeFunctions[ ]	array	true	-	指向与此处理器关联的PCIeFunction的链接数组（仅CPU资源具有）
Links.Memory [ {	array	true	-	指向与此处理器关联的内存的链接数组（仅CPU资源具有）
`Links.Memory[].@odata.id`	string	true	-	指定处理器端口集合资源的访问路径（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
} ]
Links.Chassis {	object	true	-	指向包含此处理器的机箱的链接
`Links.Chassis.@odata.id`	string	true	-	NPU模组的资源访问路径（仅NPU资源具有）
}
}
SerialNumber	string	true	-	处理器的序列号
PowerState	string	true	-	处理器的当前电源状态 ● On：上电 ● Off：下电 ● PoweringOn：正在上电 ● PoweringOff：正在下电
Status {	object	true	-	指定处理器的状态，包括： ● State：处理器是否被隔离 ● Health：处理器健康状态 ● Severity：处理器的自定义健康状态
Status.Health	string	true	-	指定处理器资源的健康状态，包括： ● OK：正常 ● Warning：警告 ● Critical：严重 ● null
Status.Oem {	object	true	-	自定义属性
Status.Oem.Public {	object	false	-	自定义属性
Status.Oem.Public.Severity	string	false	-	指定处理器资源的自定义健康状态，包括： ● Informational：正常 ● Minor：轻微 ● Major：严重 ● Critical：紧急 ● null
}
}
Status.State	string	true	-	指定处理器的状态 ● Offline：离线 ● Partiallydegraded：部分降级 ● Degraded：降级 ● Optimal：正常 ● Failed：故障 ● Not Configured：未配置 ● Interimrecovery：临时恢复 ● Readyfor recovery：准备恢复 ● Recovering：恢复中 ● Wrongdrive replaced：错误硬盘被替换 ● Driveimproperly connected：硬盘连接不正确 ● Expanding：扩容中 ● Not available：不可用 ● Queuedfor expansion：排队等待扩容 ● Disabledfrom SCSIconflict：SCSI冲突禁用 ● Ejected：已弹出 ● Erasein progress：擦除进行中 ● Unused：未使用 ● Readyto performpredictive sparerebuild：准备执行预测性热备重建 ● RPIin progress：RPI进行中 ● RPI queued：RPI排队中 ● Encryptedwithoutkey：加密但无密钥 ● Encryptionmigration：加密迁移中 ● Encrypted & re-keying：加密且正在重新密钥 ● Encryptedwith encryptionoff：加密但加密已关闭 ● Volumeencode requested：请求卷编码 ● Encryptedwithre-key request：加密且有重新密钥请求 ● Unsupported：不支持 ● Not Formatted：未格式化 ● Formatting：格式化中 ● Sanitizing：安全擦除中
}
FirmwareVersion	string	true	-	固件版本（仅GPU资源具有）
Replaceable	boolean	true	-	是否可以作为独立的部件进行替换
BaseSpeedMHZ	number	true	-	指定处理器资源的基本时钟速度（仅CPU资源具有）
OperatingSpeedMHz	number	true	-	指定处理器资源的工作频率（仅CPU资源具有）
Family	string	true	-	指定处理器资源的家族
PartNumber	string	true	-	指定处理器资源的部件编码
Oem {	object	true	-	CPU的自定义属性
Oem.Public {	object	false	-	CPU的自定义属性
Oem.Public.PartNumber	string	true	-	指定处理器资源的部件编码
Oem.Public.SerialNumber	string	true	-	处理器的序列号
Oem.Public.L1CacheKiB	number	true	-	指定处理器资源的一级缓存（仅CPU资源具有）
Oem.Public.L2CacheKiB	number	true	-	指定处理器资源的二级缓存（仅CPU资源具有）
Oem.Public.L3CacheKiB	number	true	-	指定处理器资源的三级缓存（仅CPU资源具有）
Oem.Public.DeviceLocator	string	true	-	指定处理器资源的丝印
Oem.Public.Position	string	true	-	指定处理器资源的容器
Oem.Public.Temperature	number	true	-	指定处理器资源的温度（仅CPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
Oem.Public.EnabledSetting	boolean	false	-	指定处理器资源的启用使能（仅CPU资源具有）
Oem.Public.FrequencyMHz	number	true	-	指定处理器资源的主频（仅CPU资源具有）
Oem.Public.OtherParameters	string	true	-	其他参数（仅CPU具有）
Oem.Public.TotalEnabledThreads	number	true	-	使能的超线程数（仅CPU资源具有）说明仅openUBMC 25.12 LTS版本支持
Oem.Public.PowerWatts	number	true	-	功耗说明：已屏蔽该属性值频繁变化导致的事件上报
Oem.Public.MemoryOnChip {	object	true	-	片上内存信息
Oem.Public.MemoryOnChip.OperatingSpeedMHz	number	true	-	指定处理器资源的工作频率（仅CPU资源具有）
Oem.Public.MemoryOnChip.CapacityMiB	number	true	-	片上内存容量大小，单位：MB（仅CPU资源具有）
Oem.Public.MemoryOnChip.DataWidthBits	number	true	-	片上内存位宽大小，单位：bit（仅CPU资源具有）
}
Oem.Public.CpuId	string	true	-	CPU ID
Oem.Public.Boards	object	true	-	NPU模组的资源信息（仅NPU资源具有）
Oem.Public.DueToDoubleBitErrors	object	true	-	双bit失效错误统计信息（仅GPU资源具有）
Oem.Public.DueToMultipleSingleBitErrors	object	true	-	单bit失效故障统计信息（仅GPU资源具有）
Oem.Public.ECCInfo	object	true	-	NPU的ECC信息（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
Oem.Public.EnvironmentMetrics	object	true	-	指定处理器环境指标资源
Oem.Public.ErrorStats	object	true	-	错误状态（仅GPU资源具有）
Oem.Public.EthernetInterface	object	true	-	指定处理器资源的网口信息（仅NPU资源具有）
Oem.Public.FlashIds[ ]	array	true	-	Flash厂商Id集合（仅NPU资源具有）
Oem.Public.Info	object	true	-	ECC具体字段信息（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
Oem.Public.IPv4Address	object	true	-	IPv4地址（仅NPU资源具有）
Oem.Public.Location	object	true	-	指定处理器的位置信息。
Oem.Public.Metrics	object	true	-	指定处理器指标资源（仅CPU资源具有）
Oem.Public.MultiBitEcc	object	true	-	多bit ECC信息（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
Oem.Public.MultiBitIsolatedPages	object	true	-	多bit错误隔离内存页信息（仅NPU资源具有）
Oem.Public.NvLink[ ]	array	true	-	NvLink信息（仅GPU资源具有）
Oem.Public.Ports	object	true	-	指定处理器端口集合资源（仅NPU资源具有）
Oem.Public.Power	object	true	-	功耗信息（仅GPU资源具有）
Oem.Public.RetiredPages	object	true	-	故障页列表（仅GPU资源具有）
Oem.Public.SingleBitEcc	object	true	-	单bit ECC信息（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
Oem.Public.SingleBitIsolatedPages	object	true	-	单bit错误隔离内存页信息（仅NPU资源具有）
Oem.Public.Statistics	object	true	-	统计信息（仅GPU资源具有）
Oem.Public.Thermals	object	true	-	散热信息（仅GPU资源具有）
Oem.Public.Utilization	object	true	-	GPU利用率信息（仅GPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
}
}
PartNumber	string	true	-	指定处理器资源的部件号（仅CPU资源具有）
SerialNumber	string	true	-	指定处理器资源的序列号
FirmwareVersion	string	true	-	固件版本（仅NPU资源具有）
OperatingSpeedMHz	number	true	-	片上内存速率大小，单位：MHz（仅CPU资源具有
Address	string	true	-	IPv4地址（仅NPU资源具有）
AggregateTotalCount	number	true	-	生命周期内所有单bit/多bit错误数量（仅NPU资源具有）
AiCoreCurrentSpeedMHz	number	true	-	Ai Core当前频率，单位：MHz（仅NPU资源具有）
AiCoreMaxSpeedMHz	number	true	-	Ai Core主频，单位：MHz（仅NPU资源具有）
AiCoreTempCelsius	number	true	-	Ai核温度，单位：摄氏度（仅NPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
AiCoreUsagePercent	number	true	-	Ai Core占用率，单位：百分比（仅NPU资源具有）
AiCPUUsagePercent	number	true	-	Ai CPU占用率（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
BandWidth	number	true	-	NPU处理器带宽（仅NPU资源具有）
Bank	string	true	-	ECC所在bank（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
BuildDate	string	true	-	构建时间（仅GPU资源具有）
ComputeCapability	string	true	-	算力规格（仅NPU资源具有）
CtrlCPUUsagePercent	number	true	-	ctrl CPU占用率，单位：百分比（仅NPU资源具有）
DataCRCErrorCount	number	true	-	数据CRC错误计数（仅GPU资源具有）
ECCModeEnabled	boolean	true	-	ECC模式当前使能状态（仅GPU资源具有）
ECCModePendingEnabled	boolean	true	-	ECC模式重启后使能状态（仅GPU资源具有）
ErrorCount	number	true	-	ECC计数（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
FlitCRCErrorCount	number	true	-	流控CRC错误计数（仅GPU资源具有）
Gateway	string	true	-	网关（仅NPU资源具有）
GPUPartNumber	string	true	-	部件号（仅GPU资源具有）
GPUResetRequired	boolean	true	-	是否需要重启（仅GPU资源具有）
GPUUsagePercent	number	true	-	GPU利用率（仅GPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
HBMBandwidthUsagePercent	number	true	-	HBM带宽占用率（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
HBMTempCelsius	number	true	-	HBM温度，单位：摄氏度（仅NPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
HBMUsagePercent	number	true	-	HBM占用率，单位：百分比（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
LinkStatus	string	true	-	NvLink的连接状态（仅GPU资源具有）Down Up
MACAddress	string	true	-	网口的当前MAC地址（仅NPU资源具有）
MemoryBandwidthUsagePercent	number	true	-	内存带宽占用率（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
MemoryFreeKiB	number	true	-	剩余内存大小，单位：kB（仅NPU资源具有）
MemoryPartNumber	string	true	-	内存部件号（仅GPU资源具有）
MemoryTemperatureCelsius	number	true	-	内存温度（仅GPU资源具有）
MemoryUsageKiB	number	true	-	已用内存大小，单位：kB（仅NPU资源具有）
MemoryUsagePercent	number	true	-	内存占用率，单位：百分比（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
MemoryVendor	string	true	-	内存厂商（仅GPU资源具有）Hynix Samsung
NimBusTempCelsius	number	true	-	NimBus温度，单位：摄氏度（仅NPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
NpuBoardSerialNumber	string	true	-	NPU模组的序列号信息（仅NPU资源具有）
PacketsDropped	number	true	-	丢包总数（仅NPU资源具有）
PacketsReceived	number	true	-	接收到的数据包总数（仅NPU资源具有）
PacketsTransmitted	number	true	-	发送的数据包总数（仅NPU资源具有）
PageCount	number	true	-	故障页个数（仅GPU资源具有）
PCIeDeviceId	string	true	-	PCIe设备Id（仅GPU资源具有）
PCIeSubSystemDeviceId	string	true	-	PCIe子系统设备Id（仅GPU资源具有）
PCIeSubSystemVendorId	string	true	-	PCIe子系统厂商Id（仅GPU资源具有）
PCIeVendorId	string	true	-	PCIe厂商Id（仅GPU资源具有）
PhysicalAddress	string	true	-	ECC物理地址（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
PowerBrakeIsSet	boolean	true	-	power brake状态（仅GPU资源具有）
PowerDrawWatts	number	true	-	功率（仅GPU资源具有）
PowerOn	boolean	true	-	运行状态（仅NPU资源具有）：true：运行中 false：未运行
PrimaryGPUTemperatureCelsius	number	true	-	主处理器温度（仅GPU资源具有）
RecoveryErrorCount	number	true	-	Recovery错误计数（仅GPU资源具有）
ReplayErrorCount	number	true	-	Replay错误计数（仅GPU资源具有）
RowColumn	string	true	-	ECC行列地址（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
Slot	number	true	-	NPU芯片的物理槽位信息（仅NPU资源具有）
StackPcId	string	true	-	ECC寄存器地址（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
SubnetMask	string	true	-	子网掩码（仅NPU资源具有）
SufficientExternalPower	boolean	true	-	外部供电是否充足（仅GPU资源具有）
ThermalsAlertState	string	true	-	温度告警状态（仅GPU资源具有）NoPending Pending
Time	string	true	-	ECC发生时间（仅NPU资源具有）说明 openUBMC 25.12 LTS及以上版本支持
TotalMemoryKiB	number	true	-	总内存大小，单位：kB（仅NPU资源具有）
UUID	string	true	-	UUID，格式"GPU-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"（仅GPU资源具有）
VendorId	string	true	-	处理器的厂商ID（仅NPU资源具有）
VRMTemperatureCelsius	number	true	-	VRD温度，单位：摄氏度（仅NPU资源具有）

supported_methods

GET
PATCH

HTTP methods

GET

命令功能

查询指定处理器资源信息

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/Processors/processor_id

请求头:

text


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
system_id	系统资源的ID	参见源文件参数说明
auth_value	请求消息的鉴权参数	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

无

使用实例

请求样例：

http

GET <https://device_ip/redfish/v1/Systems/system_id/Processors/processor_id>

X-Auth-Token: 123456789***********************

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#Systems/Members/1/Processors/Members/$entity",
"@odata.id": "/redfish/v1/Systems/1/Processors/1",
"@odata.type": "#Processor.v1_10_0.Processor",
"Name": "CPU1",
"Id": "1",
"ProcessorType": "CPU",
"ProcessorArchitecture": "x86",
"InstructionSet": "x86-64",
"Manufacturer": "Intel(R) Corporation",
"Model": "Intel(R) Xeon(R) CPU E5-2609 v3 @ 1.90GHz",
"ProcessorId": {
"IdentificationRegisters": "F2-06-03-00-FF-FB-EB-BF",
"EffectiveFamily": null,
"EffectiveModel": null,
"Step": null
},
"MaxSpeedMHz": 3500,
"TotalCores": 6,
"TotalThreads": 6,
"TotalEnabledCores": 32,
"Socket": 0,
"Links": {
"PCIeDevice": {
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard1"
},
"PCIeFunctions": [
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard1/Functions/1"
}
],
"Memory": [
{
"@odata.id": "/redfish/v1/Systems/1/Memory/CpuBoard1DIMM040"
}
],
"Chassis": {
"@odata.id": "/redfish/v1/Chassis/1"
}
},
"SerialNumber": "0173E2D58ACE7819",
"PowerState": "On",
"Status": {
"Health": "OK",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"State": "Enabled"
},
"FirmwareVersion": null,
"Replaceable": false,
"BaseSpeedMHZ": 100,
"OperatingSpeedMHz": 2600,
"Family": "ARM",
"PartNumber": null,
"Oem": {
"Public": {
"CpuId": "0",
"PowerWatts": null,
"L1CacheKiB": 32,
"L2CacheKiB": 256,
"L3CacheKiB": 15360,
"DeviceLocator": "CPU1",
"Position": "mainboard",
"Temperature": 40,
"EnabledSetting": true,
"PartNumber": "41020491",
"FrequencyMHz": 2000,
"OtherParameters": "64-bit Capable| Multi-Core| Execute Protection| Enhanced Virtualization| Power/Performance Control",
"SerialNumber": "0173E2D58ACE7819",
"TotalEnabledThreads": 64,
"MemoryOnChip": {
"CapacityMiB": 16384,
"DataWidthBits": 64,
"OperatingSpeedMHz": 1024
}
}
}
}

响应码：200

PATCH

命令功能

修改指定 CPU 资源属性

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/Processors/cpu_id

请求头:

text


X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value

请求消息体:

json

{
"Oem": {
"Public": {
"EnabledSetting": state
}
}
}

URL参数说明

参数	参数说明	取值
system_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
cpu_id	CPU资源的ID	可从处理器集合资源中获得。

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
EnabledSetting	CPU资源的启用状态	● true ● false

使用指南

设置CPU启用状态，只在V5及以上版本且非主CPU支持此功能。

使用实例

请求样例：

http

PATCH <https://device_ip/redfish/v1/Systems/system_id/Processors/cpu_id>

X-Auth-Token: 123456789*********************** Content-Type: header_type If-Match: ifmatch_value

请求消息体：

json

{
"Oem": {
"Public": {
"EnabledSetting": state
}
}
}

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#Systems/Members/1/Processors/Members/$entity",
"@odata.id": "/redfish/v1/Systems/1/Processors/2",
"@odata.type": "#Processor.v1_10_0.Processor",
"Name": "CPU1",
"Id": "2",
"ProcessorType": "CPU",
"ProcessorArchitecture": "x86",
"InstructionSet": "x86-64",
"Manufacturer": "Intel(R) Corporation",
"Model": "Intel(R) Xeon(R) CPU E5-2609 v3 @ 1.90GHz",
"ProcessorId": {
"IdentificationRegisters": "F2-06-03-00-FF-FB-EB-BF",
"EffectiveFamily": "6",
"EffectiveModel": "85",
"Step": "6"
},
"MaxSpeedMHz": 3500,
"TotalCores": 6,
"TotalThreads": 6,
"Socket": 0,
"Status": {
"Health": "OK",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"State": "Enabled"
},
"FirmwareVersion": null,
"Oem": {
"Public": {
"L1CacheKiB": 32,
"L2CacheKiB": 256,
"L3CacheKiB": 15360,
"DeviceLocator": "CPU2",
"Position": "mainboard",
"Temperature": 40,
"EnabledSetting": false,
"PartNumber": "41020491",
"FrequencyMHz": 2000,
"SerialNumber": "0173E2D58ACE7819"
}
}
}

响应码：200

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

PATCH ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

PATCH