All Products
Search

This Product

    Quota Center:CreateTemplateQuotaItem

    Document Center

    Quota Center:CreateTemplateQuotaItem

    Last Updated:Jun 07, 2024

    Creates a quota template by using the management account of a resource directory. After you create a quota template, if a member is added to the resource directory, the quota template automatically submits a quota increase request for the member. The quota values for existing members remain unchanged. You can use a quota template to apply for increases on multiple quotas at the same time. This automated approach improves the efficiency of quota management across your organization.

    Operation description

    Prerequisites

    You must set the ServiceStatus parameter to 1. This ensures that the quota template is enabled.

    You can call the GetQuotaTemplateServiceStatus operation to query the status of a quota template. If the ServiceStatus parameter is set to 0 or -1, you must call the ModifyQuotaTemplateServiceStatus operation to set the ServiceStatus parameter to 1.

    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
    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
    QuotaActionCodestringYes

    The quota ID.

    Note To obtain the quota ID of an Alibaba Cloud service, call the ListProductQuotas operation and check the value of QuotaActionCode in the response.
    		q_security-groups
    DesireValuefloatYes

    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 for each cloud service. To increase the success rate of your application, specify a reasonable quota value and a detailed reason.

    		804
    NoticeTypelongNo

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

    • 0 (default value): no
    • 3: yes
    		0
    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
    EnvLanguagestringNo

    The language of the quota alert notification. Valid values:

    • zh (default value): 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 leave this parameter empty, the quota takes effect immediately.
    		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 leave this parameter empty, no end time is specified.
    		2021-01-20T09:25:56Z
    QuotaCategorystringNo

    The quota type. Valid values:

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

    Response parameters

    ParameterTypeDescriptionExample
    object

    None.

    RequestIdstring

    The ID of the request.

    		D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053
    Idstring

    The ID of the quota template.

    		1****

    Examples

    Sample success responses

    JSONformat

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

    Error codes

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

    Change history

    Change timeSummary of changesOperation
    2023-09-22API Description Updatesee changesets
    Change itemChange content
    API DescriptionAPI Description Update.
    2023-05-22The internal configuration of the API is changed, but the call is not affectedsee changesets
    Change itemChange content
    The internal configuration of the API is changed, but the call is not affected.