Skip to main content

GET – CPU properties

Use the GET method to retrieve properties of CPU resource for Redfish service.

Request URL​

GET https://<BMC_IPADDR>/redfish/v1/Systems/1/Processors/{1-N}

Request body​

None

Response body​

FieldTypeDescription

Description

String

This resource is used to represent a processor for a Redfish implementation.

TotalEnabledCores

Integer

The total number of enabled cores that this processor contains.

Id

String

1~{N}, N=1- number of processors

InstructionSet

String

null if Status.state is absent, otherwise, "x86-64".

Manufacturer

String

The processor manufacturer.

MaxSpeedMHz

Number

The maximum clock speed of the processor.

Model

String

The product model of the processor.

Name

String

"Processor {N}", N is the socket number of this processor

SerialNumber

String

Serial number of this processor.

PartNumber

String

Part number of this processor.

Version

String

It is the same as the Model property.

ProcessorArchitecture

String

null if Status.state is absent, otherwise, "x86".

ProcessorId

Object

Expanded

 

EffectiveFamily

String

The effective Family for this processor.

 

EffectiveModel

String

The effective Model for this processor.

 

IdentificationRegisters

String

The contents of the Identification Registers (CPUID) for this processor.

 

MicrocodeInfo

String

null

 

Step

String

The Step value for this processor.

 

VendorId

String

The Vendor Identification for this processor.

ProcessorType

String

“CPU”

Socket

String

The socket or location of the processor.

Status

Object

Contains the following elements

 

Health

String

The health of this processor.

 

State

String

“Enabled”: processor is present

“Absent”: processor is not present

TotalCores

Number

The total number of cores contained in this processor.

TotalThreads

Number

The total number of execution threads supported by this processor.

Location

Object

The location of the processor.

 

PartLocation

Object

The part location within the placement.

  

LocationOrdinalValue

Integer

The number that represents the location of the part.

If LocationType is `slot` and this unit is in slot 2, the LocationOrdinalValue is 2.

  

LocationType

String

The type of location of the part, such as slot, bay and socket Here hard code to “Socket”

  

ServiceLabel

String

The label of the part location, such as a silk-screened name or a printed label.

TDPWatts

Integer

The nominal Thermal Design Power (TDP) in watts.

Metrics

Link

The link to the metrics associated with this processor.

ProcessorMemory

Array

The memory directly attached or integrated within this Processor.

 

MemoryType

String

The type of memory used by this processor.

 

CapacityMiB

Integer

The memory capacity in MiB.

 

IntegratedMemory

Boolean

An indication of whether this memory is integrated within the processor.

 

SpeedMHz

Integer

The operating speed of the memory in MHz.

Links

Object

Expand

 

Chassis

Link

/redfish/v1/Chassis/1/

Status code​

HTTP Status CodeError Message ID
500InternalError

Example​

The following example JSON response is returned:

{
    "SerialNumber": "",
    "Id": "1",
    "Metrics": {
        "@odata.id": "/redfish/v1/Systems/1/Processors/1/ProcessorMetrics"
    },
    "Links": {
        "Chassis": {
            "@odata.id": "/redfish/v1/Chassis/1"
        }
    },
    "Version": "Intel(R) Xeon(R) Silver 4116 CPU @ 2.10GHz",
    "TotalEnabledCores": 12,
    "InstructionSet": "x86-64",
    "PartNumber": "",
    "Location": {
        "PartLocation": {
            "LocationType": "Socket",
            "ServiceLabel": "CPU 1",
            "LocationOrdinalValue": 0
        }
    },
    "ProcessorArchitecture": "x86",
    "Description": "This resource is used to represent a processor for a Redfish implementation.",
    "@odata.id": "/redfish/v1/Systems/1/Processors/1",
    "Oem": {
        "Lenovo": {
            "ProcessorFamily": 179,
            "CacheInfo": [
                {
                    "InstalledSizeKByte": 768,
                    "MaxCacheSizeKByte": 768,
                    "CacheLevel": "L1"
                },
                {
                    "InstalledSizeKByte": 12288,
                    "MaxCacheSizeKByte": 12288,
                    "CacheLevel": "L2"
                },
                {
                    "InstalledSizeKByte": 16896,
                    "MaxCacheSizeKByte": 16896,
                    "CacheLevel": "L3"
                }
            ],
            "@odata.type": "#LenovoProcessor.v1_0_0.LenovoProcessor",
            "NumberOfEnabledCores": 12,
            "ExternalBusClockSpeedMHz": 100,
            "CurrentClockSpeedMHz": 2100
        }
    },
    "TotalThreads": 24,
    "MaxSpeedMHz": 3000,
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "ProcessorType": "CPU",
    "Name": "Processor 1",
    "ProcessorId": {
        "Step": "0x04",
        "VendorId": "GenuineIntel",
        "EffectiveModel": "0x55",
        "EffectiveFamily": "0x06",
        "IdentificationRegisters": "0x00050654bfebfbff",
        "MicrocodeInfo": null
    },
    "TotalCores": 12,
    "ProcessorMemory": [
        {
            "SpeedMHz": null,
            "MemoryType": "L1Cache",
            "IntegratedMemory": true,
            "CapacityMiB": 0
        },
        {
            "SpeedMHz": null,
            "MemoryType": "L2Cache",
            "IntegratedMemory": true,
            "CapacityMiB": 12
        },
        {
            "SpeedMHz": null,
            "MemoryType": "L3Cache",
            "IntegratedMemory": true,
            "CapacityMiB": 16
        }
    ],
    "@odata.type": "#Processor.v1_8_0.Processor",
    "TDPWatts": 85,
    "Manufacturer": "Intel(R) Corporation",
    "@odata.etag": "\"c04762c6eb9530eafca59\"",
    "Model": "Intel(R) Xeon(R) Silver 4116 CPU @ 2.10GHz",
    "Socket": "CPU 1"
}