All Products
Search
Document Center

Quota Center:CreateQuotaApplication

Last Updated:Oct 12, 2023

Submits an application to increase a quota.

Operation Description

In this example, the operation is called to submit an application to increase the value of a quota whose ID is q_security-groups and whose name is Maximum Number of Security Groups. The quota belongs to Elastic Compute Service (ECS). The expected value of the quota is 804, the application reason is Scale Out, and the ID of the region to which the quota belongs is cn-hangzhou.

debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

debugging

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 For more information, see Alibaba Cloud services that support Quota Center.
ecs
QuotaActionCodestringYes

The ID of the quota.

q_security-groups
DesireValuefloatYes

The requested value of the quota.

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 an application to increase the value of the quota.
804
ReasonstringYes

The reason for the 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 an application to increase the value of the quota.
Scale Out
NoticeTypeintegerNo

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

  • 0 (default value): sends a notification about the application result.
  • 3: A notification about the application result is sent.
0
Dimensionsobject []No

The quota dimensions.

KeystringNo

The key of the dimension.

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

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

The value of the dimension.

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

Note This parameter is required if you set the ProductCode parameter to ecs, ecs-spec, actiontrail, or ess.
cn-hangzhou
QuotaCategorystringNo

The type of the quota.

  • CommonQuota (default value): general quota
  • FlowControl: API rate limit
  • WhiteListLabel: whitelist quota
CommonQuota
AuditModestringNo

The mode in which you want the application to be reviewed. Valid values:

  • Sync: The application is reviewed in a synchronous manner. Quota Center automatically reviews the application. The result is returned immediately after you submit the application. However, the chance of an approval for an application that is reviewed in Sync mode is lower than the chance of an approval for an application that is reviewed in Async mode. The validity period of the new quota value is 1 hour.
  • Async: The application is reviewed in an asynchronous manner. An Alibaba Cloud support engineer reviews the application. The chance of an approval for an application that is reviewed in Async mode is higher than the chance of an approval for an application that is reviewed in Sync mode. The validity period of the new quota value is one month.
Note This parameter is available only for ECS Quotas by Instance Type.
Sync
EnvLanguagestringNo

The language of the quota alert notification. Valid values:

  • zh (default value): Chinese
  • en: English
zh
ExpireTimestringNo

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 default start time is the time when the quota application is submitted.
2021-01-20T09:25:56Z
EffectiveTimestringNo

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 default end time is 99 years after the quota application is submitted.
2021-01-19T09:25:56Z

For more information about common request parameters, see Common parameters.

Response parameters

ParameterTypeDescriptionExample
object

None.

RequestIdstring

The ID of the request.

D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053
Statusstring

The status of the application. Valid values:

  • Disagree: The application is rejected.
  • Agree: The application is approved.
  • Process: The application is being reviewed.
  • Cancel: The application is canceled.
Process
DesireValueinteger

The requested value of the quota.

12
QuotaActionCodestring

The ID of the quota.

ecs.c5.large
QuotaNamestring

The name of the quota.

ecs.c5.large
ApplicationIdstring

The ID of the application.

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

The reason for the application.

Scale Out
AuditReasonstring

The result of the application.

Agree
QuotaDescriptionstring

The description of the quota.

ecs.c5.large
ProductCodestring

The abbreviation of the Alibaba Cloud service name.

ecs-spec
QuotaArnstring

The Alibaba Cloud Resource Name (ARN) of the quota.

acs:quotas:cn-hangzhou:*:quota/ecs/ecs.m2.medium/prepaid/classic/instancetype/cn-hangzhou-b
ApplyTimestring

The time when the application was submitted.

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

The quota value that is approved.

804
Dimensionobject

The quota dimension.

{"regionId":"cn-hangzhou"}
NoticeTypelong

Indicates whether Quota Center sends a notification about the application result. Valid values:

  • 0: Quota Center does not send a notification.
  • 3: Quota Center sends a notification.
3
EffectiveTimestring

The time when the new quota value takes effect.

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

The time when the new quota expires.

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

The unit of the new quota value.

AMOUNT

Examples

Sample success responses

JSONformat

{
  "RequestId": "D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053",
  "Status": "Process",
  "DesireValue": 12,
  "QuotaActionCode": "ecs.c5.large",
  "QuotaName": "ecs.c5.large",
  "ApplicationId": "d314d6ae-867d-484c-9009-3d421a80****",
  "Reason": "Scale Out\n",
  "AuditReason": "Agree\n",
  "QuotaDescription": "ecs.c5.large",
  "ProductCode": "ecs-spec",
  "QuotaArn": "acs:quotas:cn-hangzhou:*:quota/ecs/ecs.m2.medium/prepaid/classic/instancetype/cn-hangzhou-b",
  "ApplyTime": "2021-01-19T09:25:56Z",
  "ApproveValue": 804,
  "Dimension": {
    "regionId": "cn-hangzhou"
  },
  "NoticeType": 3,
  "EffectiveTime": "2021-01-19T09:25:56Z",
  "ExpireTime": "2021-01-20T09:25:56Z",
  "QuotaUnit": "AMOUNT"
}

Error codes

HTTP status codeError codeError messageDescription
400ACQUIRE.LOCK.FAILThe request is too frequent. Please try again later.Too many attempts. Try again later.
400InvalidNoticeTypeInvalid NoticeTypeThe specified NoticeType parameter is invalid.
400InvalidDesireValueInvalid DesireValueThe specified DesireValue parameter is invalid.
400QUOTA.NOT.ADJUSTABLEQuota is not adjustableThe quota is not adjustable.
400QUOTA.NOT.FOUNDThe quota does not exist.The quota does not exist.
400QUOTA.APPLICATION.PROCESSThe 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.
400QUOTA.DESIREVALUE.ILLEGALThe applied quota value is invalid.The requested value is invalid.

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

Change history

Change timeSummary of changesOperation
2023-09-22API Description Update,The error codes of the API operation change.see changesets
Change itemChange content
API DescriptionAPI Description Update
Error CodesThe error codes of the API operation change.
    delete Error Codes: 400