更新时间:2024-02-01 GMT+08:00

添加阈值规则(即将下线)

功能介绍

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

URI

POST /v1/{project_id}/ams/alarms

替换接口请参考添加阈值规则

请求消息

请求参数

请求参数如表1所示。

表1 请求参数

参数

是否必选

参数类型

取值范围

描述

project_id

String

-

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

statistic

String

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

统计方式

namespace

String

-

命名空间

metricName

String

取值满足表达式[a-zA-Z_:][a-zA-Z0-9_:]*,即首字符为必须为字母_:,其他字符为字母数字_:,长度为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.

请联系技术支持工程师解决。