接口功能介绍

创建一个事件监控的告警规则。

接口约束

regionID（资源池）存在且支持事件监控产品，具体范围见请求参数说明。

URI

POST /v4/monitor/create-event-alarm-rule

路径参数 无

Query参数 无

请求参数

请求头header参数 无

请求体body参数

参数	是否必填	参数类型	说明	示例	下级对象
regionID	是	String	资源池ID	81f7728662dd11ec810800155d307d5b
name	是	String	规则名	ctyun_rule
desc	否	String	描述	demo
service	是	String	本参数表示服务。取值范围： ecs：云主机。 evs：云硬盘。 pms：物理机。 ... 云监控服务，具体服务参见云监控：查询服务维度及监控项	ecs
dimension	是	String	本参数表示告警维度。取值范围： ecs：云主机。 disk：磁盘。 pms：物理机。 ... 云监控服务，具体服务参见云监控：查询服务维度及监控项	ecs
repeatTimes	否	Integer	重复告警通知次数，默认为0，当repeatTimes值为-1，代表无限重复。	0
silenceTime	否	Integer	告警接收策略静默时间，多久重复通知一次，单位为秒	300
recoverNotify	否	Integer	本参数表示恢复是否通知。默认值0。取值范围： 0：否。 1：是。根据以上范围取值。	0
notifyType	否	Array of Strings	本参数表示告警接收策略。取值范围： email：邮件告警。 sms：短信告警。根据以上范围取值。	['email','sms']
contactGroupList	否	Array of Strings	告警联系人组	['000f0322-1f4d-8cc8-bb2e-1c30fb751ccc']
notifyWeekdays	否	Array of Integers	本参数表示通知周期。默认值[0,1,2,3,4,5,6]。取值范围： 0：周日。 1：周一。 2：周二。 3：周三。 4：周四。 5：周五。 6：周六。根据以上范围取值。	[0,1,2,3,4,5,6]
notifyStart	否	String	通知起始时段，默认为00:00:00	00:00:00
notifyEnd	否	String	通知结束时段，默认为23:59:59	23:59:59
webhookUrl	否	Array of Strings	webhook消息推送url地址	['https://www.ctyun.cn/']
projectID	否	String	项目ID	0
conditions	是	Array of Objects	具体匹配策略		condition
resources	是	Array of Objects	资源信息列表		resources
resourceScope	否	Integer	规则的资源范围，默认值0，取值范围： 0：实例资源类型。 1：资源分组类型。 2：全部资源类型。根据以上范围取值。	0
defaultContact	否	Integer	是否使用天翼云默认联系人接收通知，默认值0，取值范围： 0：否。 1：是。根据以上范围取值。	0

表 condition

参数	是否必填	参数类型	说明	示例
eventName	是	String	事件指标	EVENT63cb8954325480a320230707180
value	是	String	出现次数，告警阈值，整数格式字符串	1
period	否	String	本参数表示算法统计周期，默认值：5m。本参数格式为“数字+单位”。最大周期为24小时。单位取值范围： m：分钟。 h：小时。根据以上范围取值。	5m
level	否	Integer	本参数表示告警等级。默认值：3。取值范围： 1：紧急。 2：警示。 3：普通。根据以上范围取值。	3

表 resources

参数	是否必填	参数类型	说明	示例	下级对象
resource	是	Array of Objects	资源信息		resourceObj

表 resourceObj

参数	是否必填	参数类型	说明	示例	下级对象
name	是	String	资源实例标签键	uuid
value	是	String	资源实例标签值	17d7e40a-1f4e-bca6-fdb4-37dbb43237ee

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	返回状态码（800为成功，900为失败），默认值：800	800
errorCode	String	失败时的错误代码，参见公共错误码说明
message	String	失败时的错误描述，一般为英文描述	Success
msgDesc	String	失败时的错误描述，一般为中文描述	成功
description	String	失败时的错误描述，适配中英文	成功
error	String	错误码，请求成功时，不返回该字段	Openapi.Parameter.Error
returnObj	Object	返回对象		returnObj

表 returnObj

参数	参数类型	说明	示例	下级对象
alarmRuleIDList	Array of Strings	告警规则ID	['83bd7537-9e06-5a45-a3b5-f4b13a7e81ea']

枚举参数

无

请求示例

请求url

/v4/monitor/create-event-alarm-rule

请求头header

无

请求体body

{
    "regionID": "81f7728662dd11ec810800155d307d5b",
    "service": "ecs",
    "dimension": "ecs",
    "name": "ctyun_rule",
    "desc": "描述",
    "resources": [
        {
            "resource": [
                {
                    "name": "uuid",
                    "value": "7dd744ea-5a02-61d3-e627-38f82f5fd3e1"
                },
                {
                    "name": "instancename",
                    "value": "ecmaf97"
                }
            ]
        }
    ],
    "conditions": [
        {
            "eventName": "migration_event_start",
            "value": "15",
            "period": "1h"
        }
    ]
}

响应示例

{
    "statusCode": 800,
    "returnObj": {
        "alarmRuleIDList": [
          "83bd7537-9e06-5a45-a3b5-f4b13a7e81ea"
        ]
    },
    "errorCode": "",
    "message": "Success",
    "msgDesc": "成功",
    "description": "成功"
}

状态码

请参考状态码

错误码

请参考错误码

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

云监控服务

云监控服务

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

云监控服务

云监控服务

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码