Queries the details of the specified quota.
Operation description
In this example, the operation is called to query the details of a quota whose ID is q_security-groups
and whose name is Maximum Number of Security Groups. This quota belongs to Elastic Compute Service (ECS). The query result shows the details of the quota. The details include the name, ID, description, quota value, used quota, unit, and dimension of the quota. In this example, the quota name is Maximum Number of Security Groups
. The quota ID is q_security-groups
. The description is The maximum number of security groups that can be created for the current account
. The quota value is 801
. The used quota is 26
. The quota unit is Number of security groups
. The quota dimension is {"regionId":"cn-hangzhou"}
.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ProductCode | string | Yes | The abbreviation of the Alibaba Cloud service name. Note
For more information, see Alibaba Cloud services that support Quota Center.
Enumeration Value:
| ecs |
QuotaActionCode | string | Yes | The ID of the quota. | q_security-groups |
Dimensions | object [] | No | The quota dimensions. | {\"regionId\":\"cn-beijing\"} |
Key | string | No | The key of the dimension. Note
Dimensions.N.Key and Dimensions.N.Value parameters at the same time. The following cloud services support dimensions: ECS whose service code is ecs, Enterprise Distributed Application Service (EDAS) whose service code is edas, ECS Quotas by Instance Type whose service code is ecs-spec, and Auto Scaling (ESS) whose service code is ess. | regionId |
Value | string | No | The value of the dimension. Note
Dimensions.N.Key and Dimensions.N.Value parameters at the same time. The following cloud services support dimensions: ECS whose service code is ecs, EDAS whose service code is edas, ECS Quotas by Instance Type whose service code is ecs-spec, and ESS whose service code is ess. | cn-hangzhou |
For more information about common request parameters, see Common parameters.
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3",
"Quota": {
"QuotaUnit": "Count\n",
"QuotaActionCode": "q_security-groups",
"TotalUsage": 26,
"ApplicableRange": [
802
],
"SupportedRange": [
0
],
"QuotaType": "normal",
"QuotaDescription": "The maximum number of security groups that can be owned by the current account\n",
"Period": {
"PeriodValue": 1,
"PeriodUnit": "Day"
},
"QuotaArn": "acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups/",
"ApplicableType": "continuous",
"QuotaItems": [
{
"Type": "BaseQuota",
"Quota": "801",
"QuotaUnit": "Count\n",
"Usage": "26"
}
],
"Dimensions": {
"regionId": "cn-hangzhou"
},
"Adjustable": true,
"QuotaName": "Maximum Number of Security Groups\n",
"UnadjustableDetail": "limitReached",
"Consumable": true,
"TotalQuota": 801,
"ProductCode": "ecs",
"EffectiveTime": "2022-09-28T06:06:00Z",
"ExpireTime": "2022-09-29T06:06:00Z",
"QuotaCategory": "CommonQuota",
"ApplyReasonTips": "The business xxx is expected to grow by 50%.\n",
"GlobalQuota": true
}
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||
---|---|---|---|---|
2023-11-07 | The response structure of the API has changed | see changesets | ||
| ||||
2023-06-28 | The response structure of the API has changed | see changesets | ||
| ||||
2023-03-17 | The internal configuration of the API is changed, but the call is not affected | see changesets | ||
|