修改配额告警信息。
接口说明
-
配额告警功能已升级，本 API 即将废弃，请您使用云监控 API PutResourceMetricRules 、 PutMetricRuleTargets 修改新版配额用量告警信息。 使用 API 对新版配额告警进行操作的更多信息，请参见使用 API 管理新版配额告警。
-
本文将提供一个示例，将配额告警 ID 为
a2efa7fc-832f-47bb-8054-39e28012****、配额告警名称为规则创建数量的配额告警阈值由150修改为160。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| quotas:UpdateQuotaAlarm | update | *QuotaAlarm acs:quotas:{#regionId}:{#accountId}:quota/{#ProductCode}/{#QuotaActionCode} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| AlarmId | string | 是 | 配额告警 ID。 说明
关于如何获取配额告警 ID，请参见 ListQuotaAlarms 。
| a2efa7fc-832f-47bb-8054-39e28012**** |
| AlarmName | string | 是 | 配额告警名称。 说明
关于如何获取配额告警名称，请参见 ListQuotaAlarms 。
| 规则创建数量告警 |
| ThresholdType | string | 否 | 配额告警类型。取值：
| usable |
| Threshold | float | 否 | 配额告警阈值的数值。取值：
说明
该参数与 ThresholdPercent 必须设置一个。
| 160 |
| ThresholdPercent | float | 否 | 配额告警阈值的百分比。取值：
说明
该参数与 Threshold 必须设置一个
| 51 |
| WebHook | string | 否 | 配额中心将告警信息通过 HTTP 协议的 POST 请求发送到指定公网的 URL 地址。 | https://alert.aliyun.com/callback |
返回参数
示例
正常返回示例
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. | 配额预警阈值不能大于当前配额。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2023-10-12 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-09-22 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-09-04 | OpenAPI 错误码发生变更 | 查看变更详情 |