All Products
Search
Document Center

Quota Center:CreateQuotaApplicationsForTemplate

Last Updated:Jun 07, 2024

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 in 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.

Operation description

QPS limit

You can add a maximum of 10 quota items to a quota template at a time.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
QuotaCategorystringYes

The quota type. Valid values:

  • CommonQuota: general quota
  • FlowControl: API rate limit
  • WhiteListLabel: privilege
CommonQuota
ProductCodestringYes

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
QuotaActionCodestringYes

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
Dimensionsobject []No

The quota dimensions.

KeystringNo

The key of the dimension.

Note
  • The value range of N varies based on the number of dimensions that are supported by the related Alibaba Cloud service.

  • This parameter is required if you set the ProductCode parameter to ecs, ecs-spec, actiontrail, or ess.

regionId
ValuestringNo

The value of the dimension.

Note
  • The value range of N varies based on the number of dimensions that are supported by the related Alibaba Cloud service.

  • This parameter is required if you set the ProductCode parameter to ecs, ecs-spec, actiontrail, or ess.

cn-hangzhou
DesireValuedoubleYes

The requested value of the quota.

Note
  • You can specify DesireValue based on the values of TotalUsage and ApplicableRange in the response to the ListProductQuotas operation.

  • Applications are reviewed by the technical support team of each Alibaba Cloud service. To increase the success rate of your application, specify a reasonable quota value and a detailed reason.

12
ReasonstringYes

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
NoticeTypeintegerNo

Specifies whether to send a notification about the application result. Valid values:

  • 0 (default): no
  • 3: yes
0
EnvLanguagestringNo

The language of the notification about the application result. Valid values:

  • zh (default): Chinese
  • en: English
zh
EffectiveTimestringNo

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
ExpireTimestringNo

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
AliyunUidsarrayYes

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 .
stringYes

The Alibaba Cloud account that corresponds to the resource directory member for which the quotas are applied.

135048337611****

Response parameters

ParameterTypeDescriptionExample
object

The request result.

RequestIdstring

The request ID.

8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3
BatchQuotaApplicationIdstring

The ID of the quota application batch.

d314d6ae-867d-484c-9009-3d421a80****
AliyunUidsarray

The Alibaba Cloud accounts for which the quotas are applied.

string

The Alibaba Cloud account for which the quotas are applied.

135048337611****
FailResultsobject []

The Alibaba Cloud accounts of the members in a resource directory whose quota increase request is rejected, and the reason for the rejection.

AliyunUidstring

The Alibaba Cloud account of the members in a resource directory whose quota increase request is rejected.

135048337611****
Reasonstring

The reason for the rejection.

The quota adjustment application is being processed. Please try again later.

Examples

Sample success responses

JSONformat

{
  "RequestId": "8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3",
  "BatchQuotaApplicationId": "d314d6ae-867d-484c-9009-3d421a80****",
  "AliyunUids": [
    "135048337611****"
  ],
  "FailResults": [
    {
      "AliyunUid": "135048337611****",
      "Reason": "The quota adjustment application is being processed. Please try again later."
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-11-22The response structure of the API has changedsee changesets
Change itemChange content
Output ParametersThe response structure of the API has changed.