5.2 监控（即将下线）
5.2.3 修改阈值规则（即将下线）
功能介绍
该接口用于修改一条阈值规则，包括如下工作。
URI
PUT /v1/{project_id}/ams/alarms 替换接口请参考修改阈值规则。
请求消息
请求参数
请求参数如表5-66所示。
表5-66 请求参数
参数 是否必
选
参数类型 取值范围 描述
project_id 是 String - 租户从IAM申请到
的projectid，一般 为32位字符串。
statistic 是 String "maximum"，
"minimum"，
"average"，
"sum"，
"sampleCount"
统计方式
namespace 是 String - 命名空间，此参数
在后台将以添加阈 值规则时传入的值 保存，此处传入的 值不能将其修改。
参数 是否必 选
参数类型 取值范围 描述
metricName 是 String 取值满足表达式
alarmLevel 是 Integer - 告警级别
evaluationPeri
ods 是 Integer - 连续周期
comparisonO
perator 是 String - 阈值条件表达式
threshold 是 String - 阈值
alarmName 是 String - 阈值名称
dimensions 是 String - 指标维度，此参数
在后台将以添加阈
actionEnabled 否 Boolean - 告警是否启用
alarmActions 否 Array - 告警动作
alarmAdvice 否 String - 告警建议，请传入
空字符串。
表5-67 Header 说明
名称 是否必选 说明
X-Auth-Token 是 从IAM服务获取的用户Token。
Content-Type 是 指定类型为application/json。
请求示例
{ "actionEnabled": false, "alarmActions": [], "alarmAdvice": "", "alarmDescription": "", "alarmLevel": 3,
"alarmName": "aaaaaaaa", "comparisonOperator": ">=", "dimensions": [
{
"name": "appName", "value": "rhm-broker"
} ],
"evaluationPeriods": 1, "insufficientDataActions": [], "metricName": "cpuCoreLimit", "namespace": "PAAS.CONTAINER", "okActions": [],
"period": 60000, "statistic": "average", "threshold": 0, "unit": "Core"
}
响应消息
响应参数
响应参数如表5-68所示。
表5-68 响应参数
参数名称 类型 描述
errorCode String 响应码。
errorMessage String 响应信息描述。
alarmId Integer 阈值规则编码
响应示例
{ "errorCode": "SVCSTG.AMS.2000", "errorMessage": "success", "alarmId": 12345678 }
状态码
● 正常
状态码如表5-69所示。
表5-69 状态码
状态码 编码 描述
200 OK 请求响应成功。
● 异常
状态码如表5-70所示。更多状态码请见状态码。
表5-70 状态码
状态码 编码 描述
400 BadRequ
est 非法请求。
建议直接修改该请求，不要重试该请求。
401 Unautho
rized 在客户端提供认证信息后，返回该状态码，表明服务端 指出客户端所提供的认证信息不正确或非法。
403 Forbidde
n 请求被拒绝访问。
返回该状态码，表明请求能够到达服务端，且服务端能 够理解用户请求，但是拒绝做更多的事情，因为该请求 被设置为拒绝访问，建议直接修改该请求，不要重试该 请求。
500 InternalS erverErro r
表明服务端能被请求访问到，但是不能理解用户的请 求。
503 ServiceU navailabl e
被请求的服务无效。
建议直接修改该请求，不要重试该请求。
错误码
表5-71 错误码
错误码 错误信息 处理措施
SVCSTG_AMS_4000101 Invalid alarm name. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000102 The threshold rule name
already exists. 请更换阈值规则名称再次 创建。
错误码 错误信息 处理措施
SVCSTG_AMS_4000103 Invalid alarm description. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000104 Invalid alarm threshold. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000105 Invalid alarm period. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000106 Invalid email list. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000107 The maximum number of threshold rules has been reached.
请联系管理员扩容。
SVCSTG_AMS_4000108 Invalid time range for
alarm queries. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000109 Invalid project ID. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000115 Invalid request
parameter. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000118 Invalid number of
consecutive periods. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000119 Invalid alarm statistic. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000120 Invalid alarm comparison
operator. 请检查对应的参数是否符 合要求。
SVCSTG_AMS_4000121 The alarm does not exist. 请在界面上查看对应的阈 值规则是否存在。
SVCSTG_AMS_5000000 Internal server error. 请联系管理员解决。