服务器告警趋势
功能介绍
该 API 用于查询服务器概览、服务器开机状态和服务器运行状态
调用方法
请参见如何调用API。
URI
GET /v1/{project_id}/physicalservers/alarms/trend
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID 约束限制: 不涉及 取值范围: 账号的项目ID 默认取值: 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
from |
是 |
Integer |
参数解释: 查询开始时间戳,单位秒。 约束限制: from 必须小于 to。 取值范围: 时间戳格式 默认取值: 不涉及 |
to |
是 |
Integer |
参数解释: 查询结束时间戳,单位秒。 约束限制: from 必须小于 to。 取值范围: 时间戳格式 默认取值: 不涉及 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 调用接口的认证方式分为Token,如果您使用的Token方式,此参数为必填,请填写Token的值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
fault_hosts |
Array of FaultHost objects |
参数解释: 故障服务器数趋势 约束限制: 不涉及 |
alarm_daily_new_trends |
Array of AlarmDailyTrend objects |
参数解释: 告警每日新增趋势 约束限制: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
fault_date |
DateTime |
参数解释: 告警时间 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
new_fault_host |
Integer |
参数解释: 新增故障机器数 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
fault_host |
Array of strings |
参数解释: 故障机器SN 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
alarm_date |
DateTime |
参数解释: 告警时间 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
alarm_devices |
Array of AlarmDevice objects |
参数解释: 告警设备信息,包括设备类型及告警数量 约束限制: 不涉及 |
alarm_levels |
Array of AlarmLevel objects |
参数解释: 告警级别 约束限制: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
alarm_device |
String |
参数解释: 告警硬件 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
alarm_number |
Integer |
参数解释: 告警数量 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
alarm_level |
Integer |
参数解释: 告警级别 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
alarm_number |
Integer |
参数解释: 告警数量 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
error_msg |
String |
参数解释: 错误描述 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
error_msg |
String |
参数解释: 错误描述 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码:429
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
- |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
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 |
服务端内部错误 |
错误码
请参见错误码。