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 ● NPU ● GPU ● FPGA ● DSP ● Accelerator ● OEM
ProcessorArchitecture	string	true	-	指定处理器资源的架构（CPU、NPU资源具有） ● x86 ● IA-64 ● ARM ● MIPS ● OEM
InstructionSet	string	true	-	指定处理器资源的指令集（CPU、NPU资源具有） ● x86 ● x86-64 ● IA-64 ● ARM-A32 ● ARM-A64 ● MIPS32 ● MIPS64 ● OEM
Manufacturer	string	true	-	指定处理器资源的制造商
Model	string	true	-	指定处理器资源的型号
IdentificationRegisters	string	true	-	处理器的标识寄存器（仅CPU资源具有）
EffectiveFamily	string	true	-	处理器的有效系列（仅CPU资源具有）
EffectiveModel	string	true	-	处理器的有效型号（仅CPU资源具有）
Step	string	true	-	处理器的步进（仅CPU资源具有）
VendorId	string	true	-	处理器的厂商ID（仅NPU资源具有）
MaxSpeedMHz	number	true	-	指定处理器资源的最大主频（仅CPU资源具有）
TotalCores	number	true	-	指定处理器资源的总核数（仅CPU资源具有）
TotalThreads	number	true	-	指定处理器资源的总线程数（仅CPU资源具有）
TotalEnabledCores	number	true	-	指定处理器资源的可用核数（仅CPU资源具有）
Socket	number	true	-	指定处理器资源的插槽号（仅CPU资源具有）
PCIeDevice	object	true	-	与此处理器关联的PCIe设备的链接（仅CPU资源具有）
PCIeFunctions	array	true	-	指向与此处理器关联的PCIeFunction的链接数组（仅CPU资源具有）
Memory	array	true	-	指向与此处理器关联的内存的链接数组（仅CPU资源具有）
Chassis	object	true	-	指向包含此处理器的机箱的链接
SerialNumber	string	true	-	处理器的序列号
PowerState	string	true	-	处理器的当前电源状态 ● On ● Off ● PoweringOn ● PoweringOff
Status	object	true	-	指定处理器的状态，包括： ● State：处理器是否被隔离 ● Health：处理器健康状态 ● Severity：处理器的自定义健康状态
FirmwareVersion	string	true	-	固件版本（仅GPU资源具有）
Replaceable	布尔值	true	-	是否可以作为独立的部件进行替换
BaseSpeedMHZ	number	true	-	指定处理器资源的基本时钟速度（仅CPU资源具有）
OperatingSpeedMHz	number	true	-	指定处理器资源的工作频率（仅CPU资源具有）
Family	string	true	-	指定处理器资源的家族
PartNumber	string	true	-	指定处理器资源的部件编码
L1CacheKiB	number	true	-	指定处理器资源的一级缓存（仅CPU资源具有）
L2CacheKiB	number	true	-	指定处理器资源的二级缓存（仅CPU资源具有）
L3CacheKiB	number	true	-	指定处理器资源的三级缓存（仅CPU资源具有）
DeviceLocator	string	true	-	指定处理器资源的丝印
Position	string	true	-	指定处理器资源的容器
Temperature	number	true	-	指定处理器资源的温度（仅CPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
EnabledSetting	boolean	false	-	指定处理器资源的启用使能（仅CPU资源具有）
PartNumber	string	true	-	指定处理器资源的部件号（仅CPU资源具有）
FrequencyMHz	number	true	-	指定处理器资源的主频（仅CPU资源具有）
OtherParameters	string	true	-	其他参数（仅CPU具有）
SerialNumber	string	true	-	指定处理器资源的序列号
TotalEnabledThreads	number	true	-	使能的超线程数（仅CPU资源具有）说明仅BMC300 5.2.0版本支持
FirmwareVersion	string	true	-	固件版本（仅NPU资源具有）
FlashIds	array	true	-	Flash厂商Id集合（仅NPU资源具有）
PowerWatts	number	true	-	功耗说明已屏蔽该属性值频繁变化导致的事件上报
PowerOn	boolean	true	-	运行状态（仅NPU资源具有）： ● true：运行中 ● false：未运行
AiCoreTempCelsius	number	true	-	Ai核温度，单位：摄氏度（仅NPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
HBMTempCelsius	number	true	-	HBM温度，单位：摄氏度（仅NPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
NimBusTempCelsius	number	true	-	NimBus温度，单位：摄氏度（仅NPU资源具有）说明已屏蔽该属性值频繁变化导致的事件上报
VRMTemperatureCelsius	number	true	-	VRD温度，单位：摄氏度（仅NPU资源具有）
ComputeCapability	string	true	-	算力规格（仅NPU资源具有）
CtrlCPUUsagePercent	number	true	-	ctrl CPU占用率，单位：百分比（仅NPU资源具有）
AiCoreCurrentSpeedMHz	number	true	-	Ai Core当前频率，单位： MHz（仅NPU资源具有）
AiCoreMaxSpeedMHz	number	true	-	Ai Core主频，单位：MHz （仅NPU资源具有）
AiCoreUsagePercent	number	true	-	Ai Core占用率，单位：百分比（仅NPU资源具有）
MemoryUsagePercent	number	true	-	内存占用率，单位：百分比（仅NPU资源具有）说明 BMC300 5.1.0及以上版本支持
HBMUsagePercent	number	true	-	HBM占用率，单位：百分比（仅NPU资源具有）说明 BMC300 5.6.0及以上版本支持
MemoryBandwidthUsagePercent	number	true	-	内存带宽占用率（仅NPU资源具有）说明 BMC300 5.6.0及以上版本支持
HBMBandwidthUsagePercent	number	true	-	HBM带宽占用率（仅NPU资源具有）说明 BMC300 5.6.0及以上版本支持
AiCPUUsagePercent	number	true	-	Ai CPU占用率（仅NPU资源具有）说明 BMC300 5.6.0及以上版本支持
ECCInfo	object	true	-	NPU的ECC信息（仅NPU资源具有）说明 BMC300 5.5.0、5.6.0及以上版本支持
SingleBitEcc	object	true	-	单bit ECC信息（仅NPU资源具有）说明 BMC300 5.5.0、5.6.0及以上版本支持
MultiBitEcc	object	true	-	多bit ECC信息（仅NPU资源具有）说明 BMC300 5.5.0、5.6.0及以上版本支持
SingleBitIsolatedPages	object	true	-	单bit错误隔离内存页信息（仅NPU资源具有）
MultiBitIsolatedPages	object	true	-	多bit错误隔离内存页信息（仅NPU资源具有）
Info	object	true	-	ECC具体字段信息（仅NPU资源具有）说明 BMC300 5.8.0及以上版本支持
AggregateTotalCount	number	true	-	生命周期内所有单bit/多bit错误数量（仅NPU资源具有）
PhysicalAddress	string	true	-	ECC物理地址（仅NPU资源具有）说明 BMC300 5.8.0及以上版本支持
StackPcId	string	true	-	ECC寄存器地址（仅NPU资源具有）说明 BMC300 5.8.0及以上版本支持
RowColumn	string	true	-	ECC行列地址（仅NPU资源具有）说明 BMC300 5.8.0及以上版本支持
Bank	string	true	-	ECC所在bank（仅NPU资源具有）说明 BMC300 5.8.0及以上版本支持
ErrorCount	number	true	-	ECC计数（仅NPU资源具有）说明 BMC300 5.8.0及以上版本支持
Time	string	true	-	ECC发生时间（仅NPU资源具有）说明 BMC300 5.8.0及以上版本支持
TotalMemoryKiB	number	true	-	总内存大小，单位：kB （仅NPU资源具有）
MemoryUsageKiB	number	true	-	已用内存大小，单位：kB （仅NPU资源具有）
MemoryFreeKiB	number	true	-	剩余内存大小，单位：kB （仅NPU资源具有）
CapacityMiB	number	true	-	片上内存容量大小，单位：MB（仅CPU资源具有）
DataWidthBits	number	true	-	片上内存位宽大小，单位：bit（仅CPU资源具有）
OperatingSpeedMHz	number	true	-	片上内存速率大小，单位：MHz（仅CPU资源具有
MACAddress	string	true	-	网口的当前MAC地址（仅NPU资源具有）
Address	string	true	-	IPv4地址（仅NPU资源具有）
SubnetMask	string	true	-	子网掩码（仅NPU资源具有）
Gateway	string	true	-	网关（仅NPU资源具有）
PacketsReceived	number	true	-	接收到的数据包总数（仅NPU资源具有）
PacketsTransmitted	number	true	-	发送的数据包总数（仅NPU资源具有）
PacketsDropped	number	true	-	丢包总数（仅NPU资源具有）
Slot	number	true	-	NPU芯片的物理槽位信息（仅NPU资源具有）
NpuBoardSerialNumber	string	true	-	NPU模组的序列号信息（仅NPU资源具有）
BandWidth	number	true	-	NPU处理器带宽（仅NPU资源具有）
Boards	object	true	-	NPU模组的资源信息（仅NPU资源具有）
@odata.id	string	true	-	NPU模组的资源访问路径（仅NPU资源具有）
GPUPartNumber	string	true	-	部件号（仅GPU资源具有）
MemoryVendor	string	true	-	内存厂商（仅GPU资源具有） ● Hynix ● Samsung
MemoryPartNumber	string	true	-	内存部件号（仅GPU资源具有）
BuildDate	string	true	-	构建时间（仅GPU资源具有）
PCIeVendorId	string	true	-	PCIe厂商Id（仅GPU资源具有）
PCIeDeviceId	string	true	-	PCIe设备Id（仅GPU资源具有）
PCIeSubSystemVendorId	string	true	-	PCIe子系统厂商Id（仅GPU资源具有）
PCIeSubSystemDeviceId	string	true	-	PCIe子系统设备Id（仅GPU资源具有）
UUID	string	true	-	UUID，格式"GPU- xxxxxxxx-xxxx-xxxx-xxxx- xxxxxxxxxxxx"（仅GPU资源具有）
Power	object	true	-	功耗信息（仅GPU资源具有）
PowerDrawWatts	number	true	-	功率（仅GPU资源具有）
PowerBrakeIsSet	boolean	true	-	powerbrake状态（仅GPU资源具有）
SufficientExternalPower	boolean	true	-	外部供电是否充足（仅GPU资源具有）
Statistics	object	true	-	统计信息（仅GPU资源具有）
ErrorStats	object	true	-	错误状态（仅GPU资源具有）
ECCModeEnabled	boolean	true	-	ECC模式当前使能状态（仅GPU资源具有）
ECCModePendingEnabled	boolean	true	-	ECC模式重启后使能状态（仅GPU资源具有）
GPUResetRequired	boolean	true	-	是否需要重启（仅GPU资源具有）
RetiredPages	object	true	-	故障页列表（仅GPU资源具有）
DueToDoubleBitErrors	object	true	-	双bit失效错误统计信息（仅GPU资源具有）
PageCount	number	true	-	故障页个数（仅GPU资源具有）
DueToMultipleSingleBitErrors	object	true	-	单bit失效故障统计信息（仅GPU资源具有）
PageCount	number	true	-	故障页个数（仅GPU资源具有）
NvLink	array	true	-	NvLink信息（仅GPU资源具有）
LinkStatus	string	true	-	NvLink的连接状态（仅GPU资源具有） ● Down ● Up
ReplayErrorCount	number	true	-	Replay错误计数（仅GPU资源具有）
RecoveryErrorCount	number	true	-	Recovery错误计数（仅GPU资源具有）
FlitCRCErrorCount	number	true	-	流控CRC错误计数（仅GPU资源具有）
DataCRCErrorCount	number	true	-	数据CRC错误计数（仅GPU资源具有）
Utilization	object	true	-	GPU利用率信息（仅GPU资源具有）说明 BMC300 5.3.0及以上版本支持
GPUUsagePercent	number	true	-	GPU利用率（仅GPU资源具有）说明 BMC300 5.3.0及以上版本支持
MemoryUsagePercent	number	true	-	内存利用率（仅GPU资源具有）说明 BMC300 5.3.0及以上版本支持
Thermals	object	true	-	散热信息（仅GPU资源具有）
ThermalsAlertState	string	true	-	温度告警状态（仅GPU资源具有） ● NoPending ● Pending
PrimaryGPUTemperatureCelsius	number	true	-	主处理器温度（仅GPU资源具有）
MemoryTemperatureCelsius	number	true	-	内存温度（仅GPU资源具有）
Metrics	object	true	-	指定处理器指标资源（仅CPU资源具有）
@odata.id	string	true	-	指定处理器端口集合资源的访问路径（仅NPU资源具有）说明仅BMC300 5.12.0及以上版本支持

supported_methods

GET
PATCH

HTTP methods

GET

命令功能

查询指定处理器资源信息

命令格式

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

请求头:


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": {
      "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

请求头:


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

请求消息体:

json

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

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
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	可从处理器集合资源中获得。
ifmatch_value	请求消息的匹配参数	可通过对相应资源发起GET操作，从响应头中获取（对应于“ETag” 参数）
state	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