CreateQuotaApplicationsForTemplate - Quota Center - Alibaba Cloud Documentation Center

When you add a quota to a quota template, quota increase requests are automatically submitted only for new members in the resource directory. Existing members are not affected. To increase the quotas for existing members, you can use a quota template to submit batch requests. Only the administrator account of a resource directory can create batch quota requests.

Operation description

Limits

You can request a maximum of 10 quotas at a time.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

quotas:CreateQuotaApplicationsForTemplate

create

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
QuotaCategory	string	Yes	The quota category. Valid values: CommonQuota: general quota. FlowControl: API rate limit quota. WhiteListLabel: privilege.	CommonQuota
ProductCode	string	Yes	The abbreviation of the Alibaba Cloud service. Note For more information, see the `ProductCode` parameter in ListProducts.	ecs-spec
QuotaActionCode	string	Yes	The quota ID. Note For more information, see the `QuotaActionCode` parameter in ListProductQuotas.	ecs.g5.2xlarge
Dimensions	array<object>	No	The quota dimensions.
	object	No	The quota dimensions.
Key	string	No	The key of the quota dimension. Note The value of N depends on the number of dimensions that are supported by the Alibaba Cloud service. If `ProductCode` is set to a value such as `ecs`, `ecs-spec`, `actiontrail`, or `ess`, you must specify both the key and value of the quota dimension.	regionId
Value	string	No	The value of the quota dimension. Note The value of N depends on the number of dimensions that are supported by the Alibaba Cloud service. If `ProductCode` is set to a value such as `ecs`, `ecs-spec`, `actiontrail`, or `ess`, you must specify both the key and value of the quota dimension.	cn-hangzhou
DesireValue	number	Yes	The requested quota value. Note Set this parameter based on the `TotalUsage` and `ApplicableRange` of the target quota in ListProductQuotas. Quota applications are reviewed by the technical support of each Alibaba Cloud service. To increase the chance of your application being approved, specify a reasonable quota value and a detailed reason.	12
Reason	string	Yes	The reason for the quota application. Note Quota applications are reviewed by the technical support of each Alibaba Cloud service. To increase the chance of your application being approved, specify a reasonable quota value and a detailed reason.	Scale Out
NoticeType	integer	No	Specifies whether to send a notification for the application result. Valid values: 0 (default): No. 3: Yes.	0
EnvLanguage	string	No	The language of the notification for the application result. Valid values: zh (default): Chinese. en: English.	zh
EffectiveTime	string	No	The UTC time when the quota takes effect. This parameter applies only to privileges (WhiteListLabel). Note If you do not specify this parameter, the quota takes effect at the time of submission.	2021-01-19T09:25:56Z
ExpireTime	string	No	The UTC time when the quota expires. This parameter applies only to privileges (WhiteListLabel). Note If you do not specify this parameter, the quota expires 99 years after it takes effect.	2021-01-20T09:25:56Z
AliyunUids	array	Yes	A list of Alibaba Cloud accounts of the members in the resource directory for which you want to request a quota increase. Note You can submit batch quota increase requests for a maximum of 50 members at a time. For more information about the members of a resource directory, see ListAccounts.
	string	No	The Alibaba Cloud account of a member in the resource directory for which you want to request a quota increase.	135048337611****

Response elements

Element	Type	Description	Example
	object	The response parameters.
AliyunUids	array	A list of Alibaba Cloud accounts of the members in the resource directory for which the quota increase is requested.
	string	The Alibaba Cloud account of a member in the resource directory for which the quota increase is requested.	135048337611****
BatchQuotaApplicationId	string	The ID of the batch quota application.	d314d6ae-867d-484c-9009-3d421a80****
FailResults	array<object>	A list of Alibaba Cloud accounts of the members for which the application failed and the failure reasons.
	object	The information about a failed application, including the Alibaba Cloud account of the member and the failure reason.
AliyunUid	string	The Alibaba Cloud account of the member for which the application failed.	135048337611****
Reason	string	The reason for the failure.	The quota adjustment application is being processed. Please try again later.
RequestId	string	The request ID.	8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3

Examples

Success response

JSON format

{
  "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

HTTP status code	Error code	Error message	Description
400	QUOTA.APPLICATION.TIME.ERROE	ExpireTime cannot be earlier than the current time or EffectiveTime.	ExpireTime cannot be earlier than the current time or EffectiveTime.
400	TEMPLATE.NOT.RD.MA	The requested account is not the MA master account of RD and does not have permission to operate quota templates.	The current account is not the management account of the resource directory and does not have the permissions to manage the quota template.
400	QUOTA.APPLICATION.PROCESS	The quota adjustment application is being processed. Please try again later.	The quota application is being processed. You cannot submit an application at the time being.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.