Obtaining Server Alarm Trend

Function

This API is used to query the server overview, server startup status, and server operating status.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/physicalservers/alarms/trend

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. Constraints N/A Range Project ID of the account. Default Value N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
from	Yes	Integer	Definition Query start timestamp, in seconds. Constraints The value of from must be earlier than that of to. Range Timestamp format. Default Value N/A
to	Yes	Integer	Definition Query end timestamp, in seconds. Constraints The value of from must be earlier than that of to. Range Timestamp format. Default Value N/A

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition Requests for calling an API can be authenticated using a token. If token-based authentication is used, this parameter is mandatory and must be set to a user token. Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
fault_hosts	Array of FaultHost objects	Definition Trend of faulty servers. Constraints N/A
alarm_daily_new_trends	Array of AlarmDailyTrend objects	Definition Trend of daily new alarms. Constraints N/A

**Table 5** FaultHost
Parameter	Type	Description
fault_date	String	Definition Time when the alarm was generated. Constraints N/A Range N/A Default Value N/A
new_fault_host	Integer	Definition The number of new faulty servers. Constraints N/A Range N/A Default Value N/A
fault_host	Array of strings	Definition SN of the faulty server. Constraints N/A Range N/A Default Value N/A

**Table 6** AlarmDailyTrend
Parameter	Type	Description
alarm_date	String	Definition The time when the alarm was generated. Constraints N/A Range N/A Default Value N/A
alarm_devices	Array of AlarmDevice objects	Definition Information about devices for which an alarm was generated, including the device types and the number of alarms. Constraints N/A
alarm_levels	Array of AlarmLevel objects	Definition Alarm severity. Constraints N/A

**Table 7** AlarmDevice
Parameter	Type	Description
alarm_device	String	Definition Hardware for which an alarm was generated. Constraints N/A Range N/A Default Value N/A
alarm_number	Integer	Definition The number of alarms. Constraints N/A Range N/A Default Value N/A

**Table 8** AlarmLevel
Parameter	Type	Description
alarm_level	Integer	Definition Alarm severity. Constraints N/A Range N/A Default Value N/A
alarm_number	Integer	Definition The number of alarms. Constraints N/A Range N/A Default Value N/A

Status code: 400

**Table 9** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code.
error_msg	String	Definition Error description.

Status code: 401

**Table 10** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code.
error_msg	String	Definition Error description.

Status code: 429

**Table 11** Response body parameters
Parameter	Type	Description
-	String

Status code: 500

**Table 12** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code.
error_msg	String	Definition Error description.

Example Requests

Obtaining the server alarm trend

GET https://{endpoint}/v1/{project_id}/physicalservers/alarms/trend?from={from}&to={to}

Example Responses

Status code: 200

{
  "fault_hosts" : [ {
    "fault_date" : "2025-06-04T00:00:00+08:00",
    "new_fault_host" : 0,
    "fault_host" : [ ]
  } ],
  "alarm_daily_new_trends" : [ {
    "alarm_date" : "2025-06-04T00:00:00+08:00",
    "alarm_devices" : [ {
      "alarm_device" : "power_health",
      "alarm_number" : 0
    }, {
      "alarm_device" : "nic_health",
      "alarm_number" : 0
    }, {
      "alarm_device" : "memory_health",
      "alarm_number" : 0
    }, {
      "alarm_device" : "fan_health",
      "alarm_number" : 0
    }, {
      "alarm_device" : "disk_health",
      "alarm_number" : 0
    }, {
      "alarm_device" : "cpu_health",
      "alarm_number" : 0
    }, {
      "alarm_device" : "other_health",
      "alarm_number" : 0
    } ],
    "alarm_levels" : [ {
      "alarm_level" : 1,
      "alarm_number" : 0
    }, {
      "alarm_level" : 2,
      "alarm_number" : 0
    }, {
      "alarm_level" : 3,
      "alarm_number" : 0
    }, {
      "alarm_level" : 4,
      "alarm_number" : 0
    } ]
  } ]
}