{"base_path":"/","components":null,"consumes":"","definitions":{"CesActionInfo":{"description":"CES告警通知规则。","properties":{"notificationList":{"description":"被通知人topicUrn列表,列表最长为5,topicUrn可从SMN获取。当前不支持该字段。","items":{"type":"string"},"maxItems":1000,"type":"array"},"type":{"description":"告警动作类型,notification(邮件通知,暂不支持),autoscaling(AS使用),groupwatch(RTS使用)","type":"string"}},"required":["type","notificationList"]},"CesAlarmRule":{"description":"CES告警规则。","properties":{"alarm_action_enabled":{"default":true,"description":"是否启用该条告警触发的动作,默认为true。注:若alarm_action_enabled为true,对应的alarm_actions、insufficientdata_actions、ok_actions至少有一个不能为空。","type":"boolean"},"alarm_actions":{"description":"告警触发的动作。当前一直只支持传入一条动作。传入多条取第一条。","items":{"$ref":"#/definitions/CesActionInfo"},"maxItems":1000,"type":"array"},"alarm_description":{"description":"告警描述,只能包含0-9/az/A-Z/_/-或汉字,长度0-256。","type":"string"},"alarm_enabled":{"default":true,"description":"是否启用该条告警,默认为true。","type":"boolean"},"alarm_level":{"default":2,"description":"告警级别,默认为2。","type":"string"},"alarm_name":{"description":"告警名称,只能包含0-9/az/A-Z/_/-或汉字,长度1-128。","type":"string"},"alarm_type":{"description":"告警类型。","type":"string"},"condition":{"$ref":"#/definitions/CesCondition","description":"告警触发条件。"},"insufficientdata_actions":{"description":"数据不足触发的动作。当前一直只支持传入一条动作。传入多条取第一条。","items":{"$ref":"#/definitions/CesActionInfo"},"maxItems":1000,"type":"array"},"metric":{"$ref":"#/definitions/CesMetric","description":"告警指标。"},"ok_actions":{"description":"告警恢复触发的动作。当前一直只支持传入一条动作。传入多条取第一条。","items":{"$ref":"#/definitions/CesActionInfo"},"maxItems":1000,"type":"array"},"regionId":{"description":"区域ID。","type":"string"}},"required":["alarm_name","metric","condition"]},"CesCondition":{"description":"CES告警条件。更新时只更新一个字段也要传全量字段。","properties":{"comparison_operator":{"description":"告警阈值的比较条件,可以是>、=、<、>=、<=。","type":"string"},"count":{"description":"连续发生次数,取值范围[1,5]。","format":"int32","type":"integer"},"filter":{"description":"数据聚合的方式,支持max、min、average、sum、variance,分别表示最大值、最小值、平均值、求和值、方差值。","type":"string"},"period":{"description":"告警条件判断周期,单位为秒,支持的值为1(实时),300,1200,3600,14400,86400。","format":"int32","type":"integer"},"unit":{"description":"数据的单位,长度1-10。","type":"string"},"value":{"description":"告警阈值。取值范围[0,Number.MAX_VALUE],Number.MAX_VALUE值为1.7976931348623157e+308","type":"string"}},"required":["period","filter","comparison_operator","value","count"]},"CesDimensions":{"description":"CES告警维度。","properties":{"name":{"description":"告警描述,只能包含0-9/az/A-Z/_/-或汉字,长度0-256。","type":"string"},"value":{"description":"告警描述,只能包含0-9/az/A-Z/_/-或汉字,长度0-256。","type":"string"}},"required":["name","value"]},"CesMetric":{"description":"CES告警指标信息。","properties":{"dimensions":{"description":"指标维度列表。目前支持维度列表长度最大为3。","items":{"$ref":"#/definitions/CesDimensions"},"maxItems":1000,"type":"array"},"metric_name":{"description":"指标名称,必须以字母开头,只能包含0-9/a-z/AZ/_,长度最短为1,最大为64。","type":"string"},"namespace":{"description":"指标命名空间,必须以字母开头,只能包含0-9/a-z/AZ/_,总长度最短为3,最大为32。","type":"string"}},"required":["namespace","metric_name","dimensions"]}},"description":null,"group_id":"a58bba086da947389167b8c3715f7155","host":"hcs.cn-north-4.myhuaweicloud.com","id":"c96d63334f334414870b84c90dd2098f","info_version":"v1","method":"post","name":"CreateAlarmRule","parameters":{},"paths":{"/V1.0/{project_id}/alarms":{"post":{"consumes":["application/json"],"description":"创建一条告警规则。\n\ncurl命令调用示例:\n```\ncurl -v -H \"Content-Type:application/json\" -X POST -d \"{json}\" \"https://ip:port/v1.0/{projectId}/alarms\"\n```","operationId":"CreateAlarmRule","parameters":[{"description":"有效的token(op_service权限的用户token),token中需要包含project信息。","in":"header","name":"x-auth-token","required":false,"type":"string"},{"description":"project Id。","in":"path","name":"project_id","required":true,"type":"string"},{"description":"CES告警规则。","in":"body","name":"alarm_rule","required":true,"schema":{"$ref":"#/definitions/CesAlarmRule"}}],"produces":["application/json"],"responses":{"201":{"description":"返回生成的告警Id,{\"alarm_id\":\"al1450321795427dR8p5mQBo\"}。","examples":{"application/json":{"alarm_id":"al1450321795427dR8p5mQBo"}},"schema":{"type":"string"}},"400":{"description":"参数错误。"},"403":{"description":"URL鉴权失败。"},"404":{"description":"rest接口未找到。"},"406":{"description":"流控限流。"},"500":{"description":"默认ServiceException异常码,应用内部错误。"},"502":{"description":"网关错误。"},"503":{"description":"服务不可用。"},"504":{"description":"表示时间超时,总线超时时间300s。"},"888":{"description":"服务摘机,不提供服务。"}},"summary":"创建一条告警规则","tags":["租户保障"],"x-filter":"ManageOne,openapi","x-plane":"Tenant,OM","x-precautions":"错误码:当请求不成功时,响应体内的错误码信息请参见“ManageOne 运维面API参考 > 错误码说明 > 租户保障特性”章节。\n","x-request-examples-1":{"alarm_action_enabled":true,"alarm_actions":[{"notificationList":[],"type":"notification"}],"alarm_description":"","alarm_enabled":true,"alarm_level":2,"alarm_name":"alarm-rp0E","condition":{"comparison_operator":">=","count":1,"filter":"average","period":300,"unit":"B/s","value":6},"insufficientdata_actions":[{"notificationList":[],"type":"notification"}],"metric":{"dimensions":[{"name":"instance_id","value":"33328f02-3814-422e-b688-bfdba93d4051"}],"metric_name":"cpu_util","namespace":"SYS.ECS"},"ok_actions":[{"notificationList":[],"type":"notification"}]},"x-request-examples-description-1":"","x-request-examples-url-1":"POST https://{endpoint}","x-support-sdk":"N"}}},"product_short":"ManageOneOCHCS","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"创建一条告警规则","tags":"租户保障","uri":null,"version":"2.0"}