查詢目標云產品的配額詳情。
接口說明
本文將提供一個示例，查詢云服務器 ECS 配額q_security-groups（安全組總數量上限）的詳情。返回結果顯示目標配額的名稱為安全組總數量上限、ID 為q_security-groups、描述為當前賬戶可擁有的安全組的最大數量、配額值為801、配額使用量為26、單位為個、維度為{"regionId":"cn-hangzhou"}等信息。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| quotas:GetProductQuota | get |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ProductCode | string | 是 | 云產品的縮寫名稱。 說明
關于如何獲取云產品的縮寫名稱，請參見 ListProducts 中的 ProductCode。
| ecs |
| QuotaActionCode | string | 是 | 配額 ID。 說明
關于如何獲取目標云產品的配額 ID，請參見 ListProductQuotas 中的 QuotaActionCode。
| q_security-groups |
| Dimensions | array<object> | 否 | 配額維度。 配額項的屬性，維度（Dimensions）+配額 ID（QuotaActionCode）確定唯一的配額項。 說明
部分云產品維度必填。云產品的配額是什么，以及配額是否必填可以從 ListProductQuotaDimensions 獲取，返回參數 Requisite表示該維度是否必填。
| {\"regionId\":\"cn-beijing\"} |
| 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 |
返回參數
示例
正常返回示例
JSON格式
{
"Quota": {
"Adjustable": true,
"ApplicableRange": [
802
],
"ApplicableType": "continuous",
"ApplyReasonTips": "申請業務：xxx\n業務規模預計增長：50%",
"Consumable": true,
"Dimensions": {
"regionId": "cn-hangzhou"
},
"EffectiveTime": "2022-09-28T06:06:00Z",
"ExpireTime": "2022-09-29T06:06:00Z",
"GlobalQuota": true,
"Period": {
"PeriodUnit": "day",
"PeriodValue": 1
},
"ProductCode": "ecs",
"QuotaActionCode": "q_security-groups",
"QuotaArn": "acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups/",
"QuotaCategory": "CommonQuota",
"QuotaDescription": "當前賬戶可擁有的安全組的最大數量",
"QuotaItems": [
{
"Quota": "801",
"QuotaUnit": "個",
"Type": "BaseQuota",
"Usage": "26"
}
],
"QuotaName": "安全組總數量上限",
"QuotaType": "normal",
"QuotaUnit": "個",
"SupportedRange": [
0
],
"TotalQuota": 801,
"TotalUsage": 26,
"UnadjustableDetail": "limitReached",
"UsageMetric": {
"MetricDimensions": {
"key": "ecs"
},
"MetricName": "Usage",
"MetricNamespace": "acs_quotas_flowcontrol"
}
},
"RequestId": "8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-11-07 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
| 2023-06-28 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
| 2023-03-17 | API 內部配置變更，不影響調用 | 查看變更詳情 |