All Products
Search

This Product

    Quota Center:CreateTemplateQuotaItem

    Document Center

    Quota Center:CreateTemplateQuotaItem

    Last Updated:Nov 24, 2025

    After a management account creates a quota template, the template automatically submits a quota increase request for any new member added to the resource directory. Existing members are not affected. Quota templates allow you to request increases for multiple quota items at once, which improves the efficiency and automation of quota management for your entire organization. Only the management account of a resource directory can create quota templates.

    Operation description

    Prerequisites

    Make sure the quota template service is enabled. The ServiceStatus parameter must be 1.

    You can call the GetQuotaTemplateServiceStatus operation to query the status of the quota template service. If the ServiceStatus is 0 (not set) or -1 (disabled), you can call the ModifyQuotaTemplateServiceStatus operation to change the status to 1 (enabled).

    Usage notes

    After you create a quota template, you can call the ListQuotaApplicationsForTemplate operation to view the approval result. If the Status parameter is Agree, the request is approved.

    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:CreateTemplateQuotaItem

    create

    *TemplateQuota

    acs:quotas:{#regionId}:{#accountId}:quota/{#ProductCode}/{#QuotaActionCode}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ProductCode

    string

    Yes

    The abbreviation of the Alibaba Cloud service name.

    Note

    For more information about how to obtain the abbreviation of an Alibaba Cloud service name, see the ProductCode parameter in ListProducts.

    ecs
    QuotaActionCode

    string

    Yes

    The quota ID.

    Note

    For more information about how to obtain the quota ID of an Alibaba Cloud service, see the QuotaActionCode parameter in ListProductQuotas.

    q_security-groups
    DesireValue

    number

    Yes

    The value of the quota request.

    Note

    • Set the value of the quota request based on the TotalUsage (quota usage) and ApplicableRange (adjustable range of the quota) of the target quota in ListProductQuotas.

    • Quota requests are reviewed by the technical support of each Alibaba Cloud service. To increase the chance of approval, specify a reasonable value and a detailed reason for your request.

    804
    NoticeType

    integer

    No

    Specifies whether to send a notification for the result of the quota request. Valid values:

    • 0 (default): No.

    • 3: Yes.

    0
    Dimensions

    array<object>

    No

    The quota dimensions.

    object

    No

    The quota dimension.

    Key

    string

    No

    The key of the quota dimension.

    Note

    • The number of dimensions that you can specify depends on the Alibaba Cloud service.

    • If ProductCode is ecs, ecs-spec, actiontrail, or ess, specify both the key and value of a dimension.

    regionId
    Value

    string

    No

    The value of the quota dimension.

    Note

    • The number of dimensions that you can specify depends on the Alibaba Cloud service.

    • If ProductCode is ecs, ecs-spec, actiontrail, or ess, specify both the key and value of a dimension.

    cn-hangzhou
    EnvLanguage

    string

    No

    The language of the notification for a quota alert. 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 this parameter is empty, the quota takes effect immediately.

    2021-01-19T09:25:56Z
    ExpireTime

    string

    No

    The UTC time when the quota expires. This parameter applies only to privileges (WhiteListLabel).

    Note

    If this parameter is empty, no expiration time is specified.

    2021-01-20T09:25:56Z
    QuotaCategory

    string

    No

    The type of the quota. Valid values:

    • CommonQuota: general quota.

    • WhiteListLabel: privilege.

    • FlowControl: API rate limit.

    CommonQuota

    Response elements

    Element

    Type

    Description

    Example

    object

    None.

    Id

    string

    The ID of the quota template.

    1****
    RequestId

    string

    The request ID.

    D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053

    Examples

    Success response

    JSON format

    {
  "Id": "1****",
  "RequestId": "D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    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.DESIREVALUE.ILLEGAL DesirValue less than or equal to the current quota value, or that is not within the adjustable range. DesirValue less than or equal to the current quota value, or that is not within the adjustable range.
    400 QUOTA.NOT.ADJUSTABLE Quota is not adjustable The quota is not adjustable.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.