租户端 存储 日志服务（CLS） 告警策略相关接口 ModifyAlarm

ModifyAlarm

最近更新时间: 2025-10-20 17:05:56

1. 接口描述

接口请求域名： cls.api3.fincloud.tencent.cn。

本接口用于修改告警策略。需要至少修改一项有效内容。

默认接口请求频率限制：20次/秒。

接口更新时间：2022-10-31 11:10:35。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：ModifyAlarm
Version 是 否 String 公共参数，本接口取值：2020-10-16
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
AlarmId 是 否 String 告警策略ID。
Name 否 否 String 告警策略名称
MonitorTime 否 否 MonitorTime 监控任务运行时间点。
Condition 否 否 String 触发条件。
TriggerCount 否 否 Int64 持续周期。持续满足触发条件TriggerCount个周期后，再进行告警；最小值为1，最大值为10。
AlarmPeriod 否 否 Int64 告警重复的周期。单位是分钟。取值范围是0~1440。
AlarmNoticeIds 否 否 Array of String 关联的告警通知模板列表。
AlarmTargets 否 否 Array of AlarmTarget 监控对象列表。
Status 否 否 Bool 是否开启告警策略。
Enable 否 否 Bool 此参数对外不可见。
是否开启告警策略。默认值为true
MessageTemplate 否 否 String 用户自定义告警内容
CallBack 否 否 CallBackInfo 用户自定义回调
Analysis 否 否 Array of AnalysisDimensional 多维分析

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
InvalidParameter 参数错误。
InternalError 内部错误。
FailedOperation 操作失败。
OperationDenied 操作被拒绝。
ResourceNotFound.TopicNotExist 日志主题不存在。
InvalidParameter.AlarmConflict 告警策略已经存在。
ResourceNotFound.AlarmNotExist 告警策略不存在。
ResourceNotFound.AlarmNoticeNotExist 告警策略通知模板不存在。
FailedOperation.InvalidAlarm 该告警策略状态异常，请检查下日志主题ID是否都存在。
OperationDenied.AccountIsolate 账户欠费。
OperationDenied.AccountDestroy 账户已销毁。
OperationDenied.AccountNotExists 账户不存在。
OperationDenied.AlarmNotSupportForSearchLow 低频不支持告警。