修改配额告警信息。
接口说明
配额告警功能已升级,本 API 即将废弃,请您使用云监控 API PutResourceMetricRules 、 PutMetricRuleTargets 修改新版配额用量告警信息。 使用 API 对新版配额告警进行操作的更多信息,请参见使用 API 管理新版配额告警。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
quotas:UpdateQuotaAlarm |
update |
*QuotaAlarm
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
AlarmId |
string |
是 |
配额告警 ID。 说明
关于如何获取配额告警 ID,请参见 ListQuotaAlarms 。 |
a2efa7fc-832f-47bb-8054-39e28012**** |
AlarmName |
string |
是 |
配额告警名称。 说明
关于如何获取配额告警名称,请参见 ListQuotaAlarms 。 |
rules |
ThresholdType |
string |
否 |
配额告警类型。取值:
|
usable |
Threshold |
number |
否 |
配额告警阈值的数值。取值:
说明
该参数与 ThresholdPercent 必须设置一个。 |
160 |
ThresholdPercent |
number |
否 |
配额告警阈值的百分比。取值:
说明
该参数与 Threshold 必须设置一个 |
51 |
WebHook |
string |
否 |
配额中心将告警信息通过 HTTP 协议的 POST 请求发送到指定公网的 URL 地址。 |
https://alert.aliyun.com/callback |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
RequestId |
string |
请求 ID。 |
A95C65B3-7CF4-469E-B1D5-1CA0628A6411 |
示例
正常返回示例
JSON
格式
{
"RequestId": "A95C65B3-7CF4-469E-B1D5-1CA0628A6411"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | RAM.PERMISSION.DENIED | You are not authorized to do this action or the API input parameter is invalid. | 没有权限或者参数非法 |
400 | UNSUPPORTED.ALARM.TYPE | Unified alarm does not support alarm types for used quantity alarms, and does not support numerical threshold types of quota alarms. | 统一告警不支持告警类型为已使用量告警,并且不支持配额告警阈值类型为数值 |
400 | THRESHOLD.ILLEGAL | The alarm Threshold or ThresholdPercent is either empty or ThresholdPercent not in (0,100]. | ThresholdPercent和Threshold不能同时为空或者ThresholdPercent需要在 (0,100]的范围内。 |
400 | ALARM.NAME.REPEAT | The warning name must be unique. | 预警名称不可重复。 |
400 | ALARM.NOT.FOUND | The AlarmId provided does not exist in our records. | 配额预警不存在。 |
400 | THRESHOLD.MAx.ILLEGAL | The quota warning threshold cannot be greater than the current quota. | 配额预警阈值不能大于当前配额。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。