Skip to main content

GET – Thermal

Request

GET https://{{ip}}/redfish/v1/Chassis/{{chassis_instance}}/Thermal
Content-Type: application/json

Response

The response to the request will be in JSON format. The properties are mentioned in the following tables.

Note
The Unit for threshold values for Fan is RPM.
Table 1. Thermal Properties

Name

Type

Read only

Description

(OData Attributes)  

Refer to OData Support.

Oem

Object

 Specifies the AMI defined OEM properties.

Name

Type

Read only

Description

@odata.type

String

True

Refer to OData Support.

OwnerLUN

Number

True

  1. This is an OEM attribute and is a specific implementation of AMI.

  2. This attribute is used in combination with SensorNumber attribute to display the Sensors under the MetricProperties attribute under Telemetry Service MetricDefinitions URI.

  3. This attribute can be used to differentiate sensors with identical Sensor numbers but different LUN numbers.

Id(M)

String

True

Refer to Resource Type Definitions

Name(M)

String

True

Description

String

True

Temperatures

Array of Objects

True

This is the definition for temperature sensors.

see Temperature Properties.

Fans

Array of Objects

True

This is the definition for fans.

see Fan Properties.

Redundancy(N)(C)

Array

True

This structure is used to show redundancy for fans. The Component ids will reference the members of the redundancy groups.

Actions

Object

True

It will contain actions under Oem attribute.

Table 2. Temperature Properties

Name

Type

Read only

Description

Name(C)

String

True

The name of the Temperature sensor.

MemberId

String

True

This property shall uniquely identify the member within the collection. For services supporting Redfish v1.6 or higher, this value shall contain the zero-based array index.

SensorNumber(C)

Number

True

A numerical identifier for this temperature sensor which is unique within this resource.

Status

Object

True

Refer toResource Properties for Resource Oem.

ReadingCelsius

Number

True

The current value of the temperature sensor’s reading.

UpperThresholdNonCritical(C)

Number

True

The current reading is above the normal range but is not critical. Units shall use the same units as the related ReadingCelsius property

UpperThresholdCritical(C)

Number

True

The current reading is above the normal range but is not yet Fatal. Units shall use the same units as the related ReadingCelsius property

UpperThresholdFatal(C)

Number

True

The current reading is above the normal range and is fatal. Units shall use the same units as the related ReadCineglsius property

LowerThresholdNonCritical(C)

Number

True

The current reading is below the normal range but is not critical. Units shall use the same units as the related ReadingCelsius property

LowerThresholdCritical(C)

Number

True

The current reading is below the normal range but is not yet fatal. Units shall use the same units as the related ReadingCelsius property

LowerThresholdFatal(C)

Number

True

The value of this property shall indicate the present reading is below the normal range and is fatal. Units shall use the same units as the related ReadingCelsius property.

MinReadingRangeTemp

Number

True

The lowest possible value for CurrentReading. Units shall u the same units as the related ReadingCelsius property.

MaxReadingRangeTemp

Number

True

The highest possible value for CurrentReading. Units shall use the same units as the related ReadingCelsius property.

PhysicalContext(C)

Object

True

The affected device or region within the chassis to which this Temperature measurement applies.

see Thermal Physical Context Enum Properties.

RelatedItem(C)

Array

True

The ID(s) of the resources associated with this Power Limit

DeltaReadingCelsius

Number

True

The value of this property shall be the delta of the values of the temperature readings across this sensor and the sensor DeltaPhysicalContext.

DeltaPhysicalContext

Enum

True

The value of this property shall be a description of the affected device or region within the chassis to which the DeltaReadingCelsius temperature measurement applies, relative to PhysicalContext.

MaxAllowableOperatingValue

Number

True

The value of this property shall indicate the maximum allowable operating temperature for the equipment monitored by this temperature sensor, as specified by a standards body, manufacturer, or combination.

MinAllowableOperatingValue

Number

True

The value of this property shall indicate the minimum allowable operating temperature for the equipment monitored by this temperature sensor, as specified by a standards body, manufacturer, or a combination.

AdjustedMaxAllowableOperatingValue

Number

True

The value of this property shall indicate the adjusted maximum allowable operating temperature for the equipment monitored by this temperature sensor, as specified by a standard body, manufacturer, or a combination, and adjusted based on environmental conditions present. For example, liquid inlet temperature may be adjusted based on the available liquid pressure.

AdjustedMinAllowableOperatingValue

Number

True

The value of this property shall indicate the adjusted minimum allowable operating temperature for the equipment monitored by this temperature sensor, as specified by a standards body, manufacturer, or a combination, and adjusted based on environmental conditions present. For example, liquid inlet temperature may be adjusted based on the available liquid pressure.

OwnerLUN

Number

True

This attribute is used in combination with SensorNumberattribute to display the Sensors under the MetricPropertiesattribute under Telemetry ServiceMetricDefinitions URI. This attribute can be used to differentiate sensors with identical Sensor numbers but different LUN numbers.

Table 3. ThermalPhysicalContextEnum Properties

PhysicalContext

Enum

Description

Room

The room

Intake

The intake point of the chassis

Exhaust

The exhaust point of the chassis

Front

The front of the chassis.

Back

The back of the chassis.

Upper

The upper portion of the chassis

Lower

The lower portion of the chassis

CPU

A Processor (CPU).

GPU

A Graphics Processor (GPU).

Backplane

A backplane within the chassis

SystemBoard

The system board (PCB).

PowerSupply

A power supply.

VoltageRegulator

A voltage regulator device

StorageDevice

A storage device

NetworkingDevice

A networking device.

ComputeBay

Within a compute bay

StorageBay

Within a storage bay.

NetworkBay

Within a networking bay.

ExpansionBay

Within an expansion bay

PowerSupplyBay

Within a power supply bay

Table 4. Fan Properties

Name

Type

Read only

Description

MemberId

String

True

This property shall uniquely identify the member within the

collection. For services supporting Redfish v1.6 or higher, this value shall contain the zero-based array index

Note
The "@odata.id" identifier for the Fan Sensors shall start with 0 and "MemberId" property has the same value as the identifier.

Name(C)

String

True

The name of the Fan.

PhysicalContext(C)

Object

True

The affected device or region within the chassis to which the Temperature measurement applies.

see Thermal Physical Context Enum Properties.

Status

Object

True

Refer toResource Properties for Resource Oem.

Reading

Number

True

The current value of the fan sensor’s reading.

UpperThresholdNonCritical(C)

Number

True

The current reading is above the normal range but is not critical. Units shall use the same units as the related Reading property.

UpperThresholdCritical(C)

Number

True

The current reading is above the normal range but is not yet Fatal. Units shall use the same units as the related Reading property.

UpperThresholdFatal(C)

Number

True

The current reading is above the normal range and is fatal. Units shall use the same units as the related Reading property.

LowerThresholdNonCritical(C)

Number

True

The current reading is below the normal range but is not critical. Units shall use the same units as the related Reading property.

LowerThresholdCritical(C)

Number

True

The current reading is below the normal range but is not ye fatal. Units shall use the same units as the related Reading property.

LowerThresholdFatal(C)

Number

True

The value of this property shall indicate the present reading is below the normal range and is fatal. Units shall use the same units as the related Reading property.

MinReadingRange

Number

True

The lowest possible value for Reading. Units shall use the same units as the related Reading property.

MaxReadingRange

Number

True

The highest possible value for Reading. Units shall use the same units as the related Reading property.

RelatedItem(C)

Array

True

The ID(s) of the resources serviced with this fan.

Redundancy(C)

Array

True

Redundancy information for the power subsystem of this system.

HotPluggable

Boolean

True

The value of this property shall indicate whether the device can be inserted or removed while the underlying equipment otherwise remains in its current operational state. Devices indicated as hot-pluggable shall allow the device to become operable without altering the operational state of the underlying equipment. Devices that cannot be inserted or removed from equipment in operation,s that cannot become operable without affecting the operational state of that equipment, shall be indicated as not hot-pluggable.

Location

Array

True

See Resource.v1_8_1 schema property.

SensorNumebr

Number

True

A numerical identifier to represent the fan speed sensor.

OwnerLUN

Number

True

This is an OEM attribute and is a specific implementation o AMI. This attribute is used in combination with SensorNumberattribute to display the Sensors under the MetricPropertiesattribute underTelemetry Service MetricDefinitions URI. This attribute can be used to diferentiate sensors with identical Sensor numbers but different LUN numbers.