/mgmt/status/default/TemperatureSensors GET

Use the HTTP GET method with the /mgmt/status/default/TemperatureSensors resource to get information from sensors that read temperatures.

Resource URL

https://host:port/mgmt/status/default/TemperatureSensors
Where port is 5554 by default.

Request headers

The following header must be sent with the request:
Authorization
This header must be sent to perform authentication.

Request body format

None.

Security requirements

The caller must be authenticated as an appliance user with sufficient authority. For more information about security, see Types of user and how they are authenticated and User authorization, credential mapping, and access profiles.

Response status codes

200
Status information retrieved successfully.
400
Invalid data provided.
401
Not authenticated.
The caller must be authenticated as an appliance user. See Types of user and how they are authenticated for more information.
403
Not authorized.
The caller is authenticated but does not the authority to perform this action. See User authorization, credential mapping, and access profiles for more information.

Response headers

Content-Type
This header is returned with a value of application/json.

Response body format

The response is in JSON format. The response includes information about temperature sensors. Each object contains the following fields:
Name
String.
The name of the temperature sensor that is being monitored.
Value
Integer.
The most recent reading of the temperature sensor in degree Celsius. There are only three significant digits.
UpperNonCriticalThreshold
Integer.
The temperature at which a warning of high temperature occurs. If the current temperature is above this value, investigate the cause and correct the problem.
UpperNonRecoverableThreshold
Integer.
The temperature at which a risk of permanent damage to the appliance exists. If the current temperature is above this threshold, correct the problem immediately; otherwise, turn off the power supply of the appliance.
ReadingStatus
String.
An indicator of whether the current temperature is OK or exceeds the warning, danger, or critical threshold.
lowerNonRecoverable
The current sensor reading value is below the lower non-recoverable threshold, which indicates that there is a risk of damaging the hardware if the device is allowed to remain in this state. If you cannot diagnose and fix the cause of this reading, you should power down the device.
lowerCritical
The current sensor reading value is below the lower critical threshold, which indicates that the system is faulty, and might not be operating properly.
lowerNonCritical
The current sensor reading value is below the lower non-critical threshold, which is a warning that it is getting close to too low. The system should operate normally, but the cause of the sensor value should be investigated.
ok
The current sensor reading value is OK, and is within all limits.
upperNonCritical
The current sensor reading value is above the upper non-critical threshold, which is a warning that it is getting close to too high. The system should operate normally, but the cause of the sensor value should be investigated. This is commonly used on temperature sensors, where the investigation would be checking ambient air temperature and air flow.
upperCritical
The current sensor reading value is above the upper critical threshold, which indicates that the system is faulty, and might not be operating properly.
upperNonRecoverable
The current sensor reading value is above the upper non-recoverable threshold, which indicates that there is a risk of damaging the hardware if the device is allowed to remain in this state. If you cannot diagnose and fix the cause of this reading, you should power down the device.
failure
The reading indicates a failure. Used for non-numeric readings.
noReading
The attempt to read the sensor failed, so the status cannot be checked.
invalid
An internal software error has been detected checking the status.
UpperCriticalThreshold
Integer.
The temperature at which a critical error of high temperature occurs. If the current temperature is above this value, correct the problem immediately.

Examples

The following example requests information about temperature sensors on the appliance.

The following URL is used with the HTTP GET method:
https://localhost:5554/mgmt/status/default/TemperatureSensors
The following listing shows an example received response:
{
  "_links": {
    "self": {
      "href": "/mgmt/status/default/TemperatureSensors"
    },
    "doc": {
      "href": "/mgmt/docs/status/TemperatureSensors"
    }
  },
  "TemperatureSensors": [
    {
      "Name": "CPU 1 DIMM Channel 0 Temperature",
      "Value": 34,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "CPU 1 DIMM Channel 1 Temperature",
      "Value": 34,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "CPU 1 DIMM Channel 2 Temperature",
      "Value": 34,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "CPU 1 DIMM Channel 3 Temperature",
      "Value": 33,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "CPU 2 DIMM Channel 0 Temperature",
      "Value": 33,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "CPU 2 DIMM Channel 1 Temperature",
      "Value": 33,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "CPU 2 DIMM Channel 2 Temperature",
      "Value": 33,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "CPU 2 DIMM Channel 3 Temperature",
      "Value": 32,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "Temperature CPU1",
      "Value": 34,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "Temperature CPU2",
      "Value": 37,
      "UpperNonCriticalThreshold": 85,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 90
    },
    {
      "Name": "Temperature System 1",
      "Value": 30,
      "UpperNonCriticalThreshold": 55,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 65
    },
    {
      "Name": "Temperature System 2",
      "Value": 34,
      "UpperNonCriticalThreshold": 65,
      "UpperNonRecoverableThreshold": "",
      "ReadingStatus": "ok",
      "UpperCriticalThreshold": 75
    }
  ]
}