文档首页 > > API参考> API> 监控> 修改阈值规则

修改阈值规则

分享
更新时间: 2019/08/15 GMT+08:00

功能介绍

该接口用于修改一条阈值规则,包括如下工作。

URI

PUT /v1/{project_id}/ams/alarms

请求消息

请求参数

请求参数如表1所示。

表1 请求参数

参数

是否必选

参数类型

取值范围

描述

project_id

String

-

租户从IAM申请到的projectid,一般为32位字符串。

statistic

String

"maximum","minimum","average", "sum","sampleCount"

统计方式

namespace

String

-

命名空间,此参数在后台将以添加阈值规则时传入的值保存,此处传入的值不能将其修改。

metricName

String

名称长度为1~255个字符

指标名称,此参数在后台将以添加阈值规则时传入的值保存,此处传入的值不能将其修改。

period

Integer

-

统计周期

alarmLevel

Integer

-

告警级别

evaluationPeriods

Integer

-

连续周期

comparisonOperator

String

-

阈值条件表达式

threshold

String

-

阈值

alarmName

String

-

阈值名称

dimensions

String

-

指标维度,此参数在后台将以添加阈值规则时传入的值保存,此处传入的值不能将其修改。

unit

String

-

指标单位,此参数在后台将以添加阈值规则时传入的值保存,此处传入的值不能将其修改。

actionEnabled

Boolean

-

告警是否启用

alarmActions

Array

-

告警动作

alarmAdvice

String

-

告警建议,请传入空字符串。

alarmDescription

String

-

阈值规则描述

insufficientDataActions

Array

-

数据不足动作

okActions

Array

-

恢复动作

Header说明

请求消息头(Header)如表2所示。

表2 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"
}

响应消息

响应参数

响应参数如表3所示。

表3 响应参数

参数名称

类型

描述

errorCode

String

响应码。

errorMessage

String

响应信息描述。

alarmId

Integer

阈值规则编码

响应示例

{
    "errorCode": "SVCSTG.AMS.2000",
    "errorMessage": "success",
    "alarmId": 12345678
}

状态码

  • 正常

    状态码如表4所示。

    表4 状态码

    状态码

    编码

    描述

    200

    OK

    请求响应成功。

  • 异常

    状态码如表5所示。更多状态码请见状态码

    表5 状态码

    状态码

    编码

    描述

    400

    BadRequest

    非法请求。

    建议直接修改该请求,不要重试该请求。

    401

    Unauthorized

    在客户端提供认证信息后,返回该状态码,表明服务端指出客户端所提供的认证信息不正确或非法。

    403

    Forbidden

    请求被拒绝访问。

    返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

    500

    InternalServerError

    表明服务端能被请求访问到,但是不能理解用户的请求。

    503

    ServiceUnavailable

    被请求的服务无效。

    建议直接修改该请求,不要重试该请求。

错误码

表6 错误码

错误码

错误信息

处理措施

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.

请联系管理员解决。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区