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	null	true	-	处理器的有效系列（仅CPU资源具有）
ProcessorId.EffectiveModel	null	true	-	处理器的有效型号（仅CPU资源具有）
ProcessorId.Step	null	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资源具有）说明仅BMC300 5.12.0及以上版本支持
} ]
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	null	true	-	固件版本（仅GPU资源具有）
Replaceable	boolean	true	-	是否可以作为独立的部件进行替换
BaseSpeedMHZ	number	true	-	指定处理器资源的基本时钟速度（仅CPU资源具有）
OperatingSpeedMHz	number	true	-	指定处理器资源的工作频率（仅CPU资源具有）
Family	string	true	-	指定处理器资源的家族
PartNumber	null	true	-	指定处理器资源的部件编码
Oem {	object	true	-	自定义属性
Oem.Public {	object	false	-	自定义属性
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资源具有）说明仅BMC300 5.2.0版本支持
Oem.Public.PowerWatts	null	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
}
}
PartNumber	null	true	-	指定处理器资源的部件号（仅CPU资源具有）
SerialNumber	string	true	-	指定处理器资源的序列号
FirmwareVersion	null	true	-	固件版本（仅NPU资源具有）
OperatingSpeedMHz	number	true	-	片上内存速率大小，单位：MHz（仅CPU资源具有

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

请求头:


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