創建配額告警。
接口說明
本文將提供一個示例，為config（配置審計）的配額q_hvnoqv（規則創建數量）創建配額告警。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| quotas:CreateQuotaAlarm | create |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ProductCode | string | 是 | 云產品的縮寫名稱。 說明
關于如何獲取云產品的縮寫名稱，請參見 ListProductQuotas 中的 ProductCode。
| config |
| QuotaActionCode | string | 是 | 配額 ID。 說明
關于如何獲取云產品的配額 ID，請參見 ListProductQuotas 中的 QuotaActionCode。
| q_hvnoqv |
| AlarmName | string | 是 | 配額告警名稱。 | 規則創建數量告警 |
| ThresholdType | string | 否 | 配額告警類型。取值：
| used |
| Threshold | float | 否 | 配額告警閾值的數值。取值：
說明
該參數與 ThresholdPercent 必須設置一個。
| 150 |
| ThresholdPercent | float | 否 | 配額告警閾值的百分比。取值：
說明
該參數與 Threshold 必須設置一個。
| 50 |
| WebHook | string | 否 | 配額中心將告警信息通過 HTTP 協議的 POST 請求發送到指定公網的 URL 地址。 | https://alert.aliyun.com/callback |
| QuotaDimensions | array<object> | 否 | 配額維度列表。 | |
| object | 否 | 無。 | ||
| Key | string | 否 | 配額維度的 Key。 說明
ProductCode為ecs、ecs-spec、actiontrail、ess等時，配額維度的 Key 和 Value 必須同時設置。 | regionId |
| Value | string | 否 | 配額維度的 Value。 說明
ProductCode為ecs、ecs-spec、actiontrail、ess等時，配額維度的 Key 和 Value 必須同時設置。 | cn-hangzhou |
關于公共請求參數的詳情，請參見公共參數。
返回參數
示例
正常返回示例
JSON格式
{
"AlarmId": "18b3be23-b7b0-4d45-91bc-d0c331aa****",
"RequestId": "BD219E2B-E687-45EE-B5F3-61FB730551B1"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | QUOTA.UNSUPPORT.ALARM | This quota does not support creating alarm | - |
| 400 | ALARM.NAME.REPEAT | The warning name must be unique. | 預警名稱不可重復。 |
| 400 | QUOTA.ALARM.MAX | Quota alarm have reached the upper limit of 100 | 已達配額預警數上限。 |
| 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. | 統一告警不支持告警類型為已使用量告警，并且不支持配額告警閾值類型為數值 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-10-12 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-09-22 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |