創建配額提升申請。
接口說明
說明
創建配額提升申請后,您可以調用 ListQuotaApplications 接口查看審批結果,當
Status
顯示為Agree
時,表示審批通過。
本文將提供一個示例,為云服務器 ECS 的配額q_security-groups
(安全組總數量上限)申請提升配額,配額值為804
,配額申請原因為擴容
,配額所屬地域為cn-hangzhou
。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
quotas:CreateQuotaApplication | create |
|
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ProductCode | string | 是 | 云產品的縮寫名稱。 說明
關于如何獲取云產品的縮寫名稱,請參見 ListProductQuotas 中的 ProductCode 。
| ecs |
QuotaActionCode | string | 是 | 配額 ID。 說明
關于如何獲取云產品的配額 ID,請參見 ListProductQuotas 中的 QuotaActionCode 。
| q_security-groups |
DesireValue | float | 是 | 配額申請的值。 說明
TotalUsage (配額用量)和ApplicableRange (配額項可申請范圍)來設置配額申請值。 | 804 |
Reason | string | 是 | 配額申請的原因。 說明
配額申請由各云產品的技術支持進行審批。如果您想增加通過幾率,請在配額申請時填寫合理的申請數值和詳盡的申請理由。
| 擴容 |
NoticeType | integer | 否 | 配額申請結果是否發送通知。取值:
| 0 |
Dimensions | array<object> | 否 | 配額維度。 配額項的屬性,維度(Dimensions)+配額 ID(QuotaActionCode)確定唯一的配額項。 說明
部分云產品維度必填。您可以從 ListProductQuotaDimensions 查詢云產品支持的配額維度,返回參數 Requisite 表示該維度是否必填。
| |
object | 否 | 配額維度。 | ||
Key | string | 否 | 配額維度的 Key。 說明
Dimensions.N.Key 和Dimensions.N.Value 必須同時設置。N 的取值范圍取決于對應云產品支持的維度個數,您可以通過 ListProductQuotaDimensions 查詢云產品支持的配額維度,返回數組長度就是 N。
| regionId |
Value | string | 否 | 配額維度的 Value。 說明
Dimensions.N.Key 和Dimensions.N.Value 必須同時設置。N 的取值范圍取決于對應云產品支持的維度個數,您可以通過 ListProductQuotaDimensions 查詢云產品支持的配額維度,返回數組長度就是 N。
| cn-hangzhou |
QuotaCategory | string | 否 | 配額類型。 默認值:CommonQuota。 枚舉值:
| CommonQuota |
AuditMode | string | 否 | 注意 該參數廢棄,不建議使用。 配額審核模式。 枚舉值:
| Sync |
EnvLanguage | string | 否 | 配額告警通知的語言。 枚舉值:
| zh |
ExpireTime | string | 否 | 配額失效的 UTC 時間。 該參數僅適用于權益配額(WhiteListLabel)。 說明
當您未選擇失效時間時,默認為提交時間。
| 2021-01-20T09:25:56Z |
EffectiveTime | string | 否 | 配額生效的 UTC 時間。 該參數僅適用于權益配額(WhiteListLabel)。 說明
當您未選擇生效時間時,默認為當前配額開始時間起 99 年。
| 2021-01-19T09:25:56Z |
返回參數
示例
正常返回示例
JSON
格式
{
"ApplicationId": "d314d6ae-867d-484c-9009-3d421a80****",
"ApplyTime": "2021-01-19T09:25:56Z",
"ApproveValue": 804,
"AuditReason": "同意",
"DesireValue": 804,
"Dimension": {
"regionId": "cn-hangzhou"
},
"EffectiveTime": "2021-01-19T09:25:56Z",
"ExpireTime": "2021-01-20T09:25:56Z",
"NoticeType": 3,
"ProductCode": "ecs",
"QuotaActionCode": "q_security-groups",
"QuotaArn": "acs:quotas::141339776561****:quota/ecs/q_security-groups",
"QuotaDescription": "當前賬戶可擁有的安全組的最大數量",
"QuotaName": "安全組總數量上限",
"QuotaUnit": "個",
"Reason": "擴容",
"RequestId": "D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053",
"Status": "Process"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | ACQUIRE.LOCK.FAIL | The request is too frequent. Please try again later. | 訪問頻繁,請稍后重試。 |
400 | InvalidNoticeType | Invalid NoticeType | 參數NoticeType無效。 |
400 | InvalidDesireValue | Invalid DesireValue | 參數 DesireValue 無效。 |
400 | QUOTA.NOT.ADJUSTABLE | Quota is not adjustable | 配額不可調整。 |
400 | QUOTA.NOT.FOUND | The quota does not exist. | 配額不存在。 |
400 | QUOTA.APPLICATION.PROCESS | The quota adjustment application is being processed. Please try again later. | 配額申請調整處理中,暫不能提交申請。 |
400 | QUOTA.DESIREVALUE.ILLEGAL | The applied quota value is invalid. | - |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2023-09-22 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |