获取节点相关告警
功能介绍
通过内置告警规则,进行节点相关告警
URI
POST /v1/{project_id}/node-provider/nodes/{node_id}/alarms/{alert_type}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID 最小长度:32 最大长度:32 |
|
node_id |
是 |
String |
节点ID 最小长度:36 最大长度:45 |
|
alert_type |
是 |
String |
查询类型,active_alert代表查询活动告警,history_alert代表查询历史告警 最小长度:1 最大长度:15 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token 最小长度:1 最大长度:65535 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
time_range |
是 |
String |
用于指标查询时间范围,主要用于解决客户端时间和服务端时间不一致情况下,查询最近N分钟的数据。另可用于精确查询某一段时间的数据.查询时间范围,-1.-1.30(表示最近30分钟) 最小长度:0 最大长度:100 |
|
sort |
否 |
Sort object |
返回列表的排序方式 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
Array of AlarmInfo objects |
告警列表 数组长度:0 - 1000 |
|
count |
Integer |
总数 最小值:0 最大值:1000 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
事件或者告警id,系统会自动生成,上报无须填写该字段 最小长度:0 最大长度:100 |
|
starts_at |
Long |
事件或者告警产生的时间,CST毫秒级时间戳 最小值:0 最大值:9223372036854775807 |
|
ends_at |
Long |
事件或者告警清除的时间,CST毫秒级时间戳,为0时表示未删除 最小值:0 最大值:9223372036854775807 |
|
timeout |
Long |
告警自动清除时间。毫秒数,例如一分钟则填写为60000。默认清除时间为3天,对应数字为 4320 * 1000(即:3天 * 24小时 * 60分钟 * 1000毫秒) 最小值:0 最大值:9223372036854775807 |
|
metadata |
Object |
事件或者告警的详细信息 |
|
annotations |
Object |
告警详情 |
状态码: 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
状态码 最小长度:3 最大长度:3 |
|
error_code |
String |
错误码 最小长度:12 最大长度:12 |
|
error_msg |
String |
错误信息 最小长度:1 最大长度:65535 |
|
message |
String |
错误详细信息 最小长度:0 最大长度:65535 |
状态码: 401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
状态码 最小长度:3 最大长度:3 |
|
error_code |
String |
错误码 最小长度:12 最大长度:12 |
|
error_msg |
String |
错误信息 最小长度:1 最大长度:65535 |
|
message |
String |
错误详细信息 最小长度:0 最大长度:65535 |
状态码: 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
状态码 最小长度:3 最大长度:3 |
|
error_code |
String |
错误码 最小长度:12 最大长度:12 |
|
error_msg |
String |
错误信息 最小长度:1 最大长度:65535 |
|
message |
String |
错误详细信息 最小长度:0 最大长度:65535 |
请求示例
{
"time_range" : "-1.-1.30",
"sort" : {
"order_by" : [ "starts_at" ],
"order" : "desc"
}
}
响应示例
状态码: 200
请求成功
{
"data" : [ {
"id" : "3512004942693961460",
"starts_at" : 1671518362723,
"ends_at" : 1671518362723,
"timeout" : 1440000,
"metadata" : "string",
"annotations" : "string"
} ],
"count" : 1
}
状态码: 400
请求参数校验不通过
{
"code" : 400,
"error_code" : "BCS.03400001",
"error_msg" : "Invalid request.",
"message" : "unmarshal request data error"
}
状态码: 401
鉴权失败
{
"code" : 401,
"error_code" : "BCS.03401001",
"error_msg" : "Authorization failed.",
"message" : "request token is not valid"
}
状态码: 500
服务内部执行错误
{
"code" : 500,
"error_code" : "BCS.03500001",
"error_msg" : "Internal error.",
"message" : "project [xxx] node [xxx] get service bearer user token error"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求成功 |
|
400 |
请求参数校验不通过 |
|
401 |
鉴权失败 |
|
500 |
服务内部执行错误 |
错误码
请参见错误码。