Submits a quota increase application. After you add a quota item to a quota template, the system automatically submits quota applications only for new members of the resource directory. The quota values for existing members remain unchanged. If you want to increase the quota values of existing members, you can submit a quota application for the members by applying quota templates to the members. Only the management account of a resource directory can create multiple quota applications at a time.
Operation description
Debugging
Authorization information
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level,
All Resourcesis used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| quotas:CreateQuotaApplicationsForTemplate | create |
|
| none |
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| QuotaCategory | string | Yes | The quota type. Valid values:
| CommonQuota |
| ProductCode | string | Yes | The abbreviation of the Alibaba Cloud service name. Note
To query the abbreviation of an Alibaba Cloud service name, call the ListProducts operation and check the value of ProductCode in the response.
| ecs-spec |
| QuotaActionCode | string | Yes | The quota ID. Note
To query the quota ID of an Alibaba Cloud service, call the ListProductQuotas and check the value of QuotaActionCode in the response.
| ecs.g5.2xlarge |
| Dimensions | array<object> | No | The quota dimensions. | |
| DimensionItem | object | No | ||
| Key | string | No | The key of the dimension. Note
| regionId |
| Value | string | No | The value of the dimension. Note
| cn-hangzhou |
| DesireValue | double | Yes | The requested value of the quota. Note
| 12 |
| Reason | string | Yes | The reason for the quota application. Note
Applications are reviewed by the technical support team of each Alibaba Cloud service. To increase the success rate of your application, you must specify a reasonable quota value and detailed reasons when you submit the application.
| Scale Out |
| NoticeType | integer | No | Specifies whether to send a notification about the application result. Valid values:
| 0 |
| EnvLanguage | string | No | The language of the notification about the application result. Valid values:
| zh |
| EffectiveTime | string | No | The start time of the validity period of the quota. Specify the value in UTC. This parameter is valid only if you set the QuotaCategory parameter to WhiteListLabel. Note
If you do not specify a start time, the value is the time when the quota application is submitted.
| 2021-01-19T09:25:56Z |
| ExpireTime | string | No | The end time of the validity period of the quota. Specify the value in UTC. This parameter is valid only if you set the QuotaCategory parameter to WhiteListLabel. Note
If you do not specify an end time, the value is 99 years after the start time of the validity period.
| 2021-01-20T09:25:56Z |
| AliyunUids | array | Yes | The Alibaba Cloud accounts that correspond to the resource directory members for which the quotas are applied. Note
You can submit a quota increase application for a maximum of 50 members at a time. For more information about the members of a resource directory, see ListAccounts .
| |
| AliyunUid | string | Yes | The Alibaba Cloud account that corresponds to the resource directory member for which the quotas are applied. | 135048337611**** |
Response parameters
Examples
Sample success responses
JSONformat
{
"AliyunUids": [
"135048337611****"
],
"BatchQuotaApplicationId": "d314d6ae-867d-484c-9009-3d421a80****",
"FailResults": [
{
"AliyunUid": "135048337611****",
"Reason": "The quota adjustment application is being processed. Please try again later."
}
],
"RequestId": "8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3"
}Error codes
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2023-11-22 | The response structure of the API has changed | View Change Details |