文档首页/ 云化数据中心 CloudDC/ API参考/ API/ 物理服务器诊断/ 服务器告警趋势 - ShowAlarmTrend
更新时间：2026-08-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

服务器告警趋势 - ShowAlarmTrend

功能介绍

该 API 用于查询服务器概览、服务器开机状态和服务器运行状态

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

clouddc::listAlarmTrend

List

-

-

-

ces:alarmHistory:list

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID

约束限制：

不涉及

取值范围：

账号的项目ID

默认取值：

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

from

是

Integer

参数解释：

查询开始时间戳，单位秒。

约束限制：

from 必须小于 to。

取值范围：

时间戳格式

默认取值：

不涉及

to

是

Integer

参数解释：

查询结束时间戳，单位秒。

约束限制：

from 必须小于 to。

取值范围：

时间戳格式

默认取值：

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

调用接口的认证方式分为Token，如果您使用的Token方式，此参数为必填，请填写Token的值

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

fault_hosts

Array of FaultHost objects

参数解释：

故障服务器数趋势

约束限制：

不涉及

alarm_daily_new_trends

Array of AlarmDailyTrend objects

参数解释：

告警每日新增趋势

约束限制：

不涉及
表5 FaultHost

参数

参数类型

描述

fault_date

String

参数解释：

告警时间

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

new_fault_host

Integer

参数解释：

新增故障机器数

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

fault_host

Array of strings

参数解释：

故障机器SN

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表6 AlarmDailyTrend

参数

参数类型

描述

alarm_date

String

参数解释：

告警时间

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

alarm_devices

Array of AlarmDevice objects

参数解释：

告警设备信息，包括设备类型及告警数量

约束限制：

不涉及

alarm_levels

Array of AlarmLevel objects

参数解释：

告警级别

约束限制：

不涉及
表7 AlarmDevice

参数

参数类型

描述

alarm_device

String

参数解释：

告警硬件

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

alarm_number

Integer

参数解释：

告警数量

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表8 AlarmLevel

参数

参数类型

描述

alarm_level

Integer

参数解释：

告警级别

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

alarm_number

Integer

参数解释：

告警数量

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

状态码：400

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

error_msg

String

参数解释：

错误描述

状态码：401

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

error_msg

String

参数解释：

错误描述

状态码：429

表11 响应Body参数

参数

参数类型

描述

-

String

-

状态码：500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

error_msg

String

参数解释：

错误描述

请求示例

服务器告警趋势

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

响应示例

状态码：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
    } ]
  } ]
}

状态码

状态码

描述

200

-

400

请求参数错误，请求失败

401

请求未鉴权

429

请求过载

500

服务端内部错误

错误码

请参见错误码。

父主题： 物理服务器诊断