修改告警触发策略

最近更新时间: 2026-11-07 00:12:51

1. 接口描述

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

本接口（ModifyScalingPolicy）用于修改告警触发策略。

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

接口更新时间：2019-10-31 18:33:33。

接口既验签名又鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：ModifyScalingPolicy
Version 是 否 String 公共参数，本接口取值：2018-04-19
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
AutoScalingPolicyId 是 否 String 告警策略ID。
示例值： asp-iir70sxv
ScalingPolicyName 否 否 String 告警策略名称。
示例值： cpu_policy_
AdjustmentType 否 否 String 告警触发后，期望实例数修改方式。取值 ：
  • CHANGE_IN_CAPACITY：增加或减少若干期望实例数
  • EXACT_CAPACITY：调整至指定期望实例数
    •  
  • PERCENT_CHANGE_IN_CAPACITY：按百分比调整期望实例数

    • 示例值： CHANGE_IN_CAPACITY
    AdjustmentValue 否 否 Int64 告警触发后，期望实例数的调整值。取值：
  • 当 AdjustmentType 为 CHANGE_IN_CAPACITY 时，AdjustmentValue 为正数表示告警触发后增加实例，为负数表示告警触发后减少实例 
    •  
  •  当 AdjustmentType 为 EXACT_CAPACITY 时，AdjustmentValue 的值即为告警触发后新的期望实例数，需要大于或等于0 
    •  
  •  当 AdjustmentType 为 PERCENT_CHANGE_IN_CAPACITY 时，AdjusmentValue 为正数表示告警触发后按百分比增加实例，为负数表示告警触发后按百分比减少实例，单位是：%。
    示例值： 1
    		•
    Cooldown 否 否 Uint64 冷却时间，单位为秒。
    示例值： 60
    MetricAlarm 否 否 MetricAlarm 告警监控指标。
    示例值：查看
    NotificationUserGroupIds 否 否 Array of String 通知组ID，即为用户组ID集合，用户组ID可以通过DescribeUserGroup查询。
    如果需要清空通知用户组，需要在列表中传入特定字符串 "NULL"。
    示例值： ["1678\n"]

    3. 输出参数

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

    4. 错误码

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

    错误码 描述
    ResourceNotFound.ScalingPolicyNotFound 告警策略不存在。
    InvalidParameterValue.ScalingPolicyNameDuplicate 告警策略名称重复。

    5. 示例

    示例1 修改告警触发策略

    输入示例

    https://as.api3.fincloud.tencent.cn/?Action=ModifyScalingPolicy
&AutoScalingPolicyId=asp-iir70sxv
&ScalingPolicyName=cpu_policy_test
&AdjustmentType=CHANGE_IN_CAPACITY
&AdjustmentValue=1
&Cooldown=60
&MetricAlarm.ComparisonOperator=GREATER_THAN
&MetricAlarm.MetricName=CPU_USAGE
&MetricAlarm.Statistic=AVERAGE
&MetricAlarm.Threshold=50
&MetricAlarm.Period=60
&MetricAlarm.ContinuousTime=5
&NotificationUserGroupIds.0=1678
&<Common Parameters>

    输出示例

    {
    "Response": {
        "RequestId": "91413a64-9587-486b-aef4-9aba5e8a0068"
    }
}