查詢目標云產品的配額列表。
接口說明
本文將提供一個示例，查詢云服務 ECS 規格配額ecs.g5.2xlarge的配額列表。返回結果顯示，目標配額的名稱、ID、單位、維度、周期等信息。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| quotas:ListProductQuotas | list |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| NextToken | string | 否 | 是否擁有下一次查詢的令牌（Token）。
| AAAAAd**** |
| MaxResults | integer | 否 | 本次查詢的最大記錄條數。 取值范圍：1~100。默認值：30。 | 30 |
| ProductCode | string | 是 | 云產品的縮寫名稱。 說明
關于如何獲取云產品的縮寫名稱，請參見 ListProducts 中的 ProductCode。
| ecs |
| QuotaActionCode | string | 否 | 配額 ID。 | q_security-groups |
| KeyWord | string | 否 | 配額的搜索關鍵字。 說明
該參數僅針對云服務器 ECS 規格配額（ecs-spec），搜索范圍： QuotaName，QuotaActionCode。
| security |
| SortField | string | 否 | 配額支持的排序方式。 說明
該參數僅針對云服務器 ECS 規格配額（ecs-spec），如果不設置，則為空。
枚舉值：
| TIME |
| SortOrder | string | 否 | 配額支持的排序方式。 說明
該參數僅針對云服務器 ECS 規格配額（ecs-spec），如果不設置，則為空。
枚舉值：
| Ascending |
| Dimensions | array<object> | 否 | 配額維度。 | |
| object | 否 | 配額維度。 | ||
| Key | string | 否 | 配額維度的 Key。 說明
N 的取值范圍取決于對應云產品支持的維度個數。
| regionId |
| Value | string | 否 | 配額維度的 Value。 說明
N 的取值范圍取決于對應云產品支持的維度個數。
| cn-hangzhou |
| QuotaCategory | string | 否 | 配額種類。 默認值：CommonQuota。 枚舉值：
| FlowControl |
| GroupCode | string | 否 | 維度組代碼。 | entconsole_w1j3msbo2g |
返回參數
示例
正常返回示例
JSON格式
{
"MaxResults": 1,
"NextToken": "AAAAAd****",
"Quotas": [
{
"Adjustable": true,
"ApplicableRange": [
0
],
"ApplicableType": "discontinuous",
"ApplyReasonTips": "申請業務：xxx\n業務規模預計增長：50%",
"Consumable": true,
"Dimensions": {
"regionId": "cn-hangzhou"
},
"EffectiveTime": "2022-09-28T06:07:00Z",
"ExpireTime": "2022-09-29T06:07:00Z",
"GlobalQuota": true,
"Period": {
"PeriodUnit": "day",
"PeriodValue": 0
},
"ProductCode": "ecs",
"QuotaActionCode": "q_security-groups",
"QuotaArn": "acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups",
"QuotaCategory": "CommonQuota",
"QuotaDescription": "當前賬戶可擁有的安全組的最大數量",
"QuotaItems": [
{
"Quota": "1009",
"QuotaUnit": "個",
"Type": "BaseQuota",
"Usage": "1009"
}
],
"QuotaName": "ecs.g5.2xlarge",
"QuotaType": "privilege",
"QuotaUnit": "個",
"SupportedRange": [
0
],
"TotalQuota": 200,
"TotalUsage": 1009,
"UnadjustableDetail": "applicationProcess",
"UsageMetric": {
"MetricDimensions": {
"key": "ecs"
},
"MetricName": "Usage",
"MetricNamespace": "acs_quotas_flowcontrol"
}
}
],
"RequestId": "D0131FD5-5397-44FE-BF5A-4B7165B813CC",
"TotalCount": 1
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidSortOrder | Invalid SortOrder | 參數SortOrder無效。 |
| 400 | INVALID.MAX.RESULTS | The maxResults parameter is invalid. Use an integer ranging from 1 to 100. | maxResults參數不合法，請使用1~100范圍內的整數。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-11-07 | OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更 | 查看變更詳情 |
| 2023-09-22 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-06-28 | OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更 | 查看變更詳情 |
| 2022-12-02 | OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更 | 查看變更詳情 |