All Products
Search

This Product

    Quota Center:ModifyTemplateQuotaItem

    Document Center

    Quota Center:ModifyTemplateQuotaItem

    Last Updated:Oct 16, 2025

    Only the administrator account of a resource directory can modify a quota template. Modifications to a quota template apply only to new members that are added to the resource directory and do not affect existing members.

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

    update

    *TemplateQuota

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    Id

    string

    Yes

    The ID of the quota template. For more information about how to obtain the ID of a quota template, see ListQuotaApplicationTemplates.

    1****
    ProductCode

    string

    No

    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

    No

    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
    Dimensions

    array<object>

    No

    The quota dimensions.

    object

    No

    The quota dimension.

    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 you set ProductCode 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 you set ProductCode 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

    No

    The value of the quota that you want to apply for.

    Note

    • You can set this parameter based on the TotalUsage (quota usage) and ApplicableRange (the range of values for the quota) parameters of the target quota in ListProductQuotas.

    • The quota application is reviewed by the technical support of each Alibaba Cloud service. To increase the success rate of your application, you must specify a reasonable quota value and a detailed reason when you submit the application.

    804
    NoticeType

    integer

    No

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

    • 0 (default): no.

    • 3: yes.

    0
    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 is applicable only to privileges (WhiteListLabel).

    Note

    If you do not specify this parameter, the quota takes effect immediately.

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

    string

    No

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

    Note

    If you do not specify this parameter, the quota does not expire.

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

    string

    No

    The quota type. Valid values:

    • CommonQuota (default): general quota.

    • WhiteListLabel: privilege.

    • FlowControl: API rate limit.

    CommonQuota

    Response elements

    Parameter

    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.FOUND Quota template does not exist.
    400 UNSUPPORT.UPDATE.PRODUCTCODE.QUOTACODE Modification of product name, quota code and dimension data is not supported
    400 RAM.PERMISSION.DENIED You are not authorized to do this action or the API input parameter is invalid.
    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.
    400 QUOTA.DESIREVALUE.ILLEGAL DesirValue less than or equal to the current quota value, or that is not within the adjustable range.
    400 UNSUPPORT.UPDATE.DIMENSIONS The Quota dimension don't support be modified when you update quota template.
    400 TEMPLATE.ITEM.NOT.FOUND Quota template item does not exist.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.