CreateQuotaApplication - Quota Center - Alibaba Cloud Documentation Center

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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
ProductCode	string	Yes	The abbreviation of the Alibaba Cloud service name. Note For more information, see Alibaba Cloud services that support Quota Center.	ecs
QuotaActionCode	string	Yes	The ID of the quota.	q_security-groups
DesireValue	float	Yes	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
Reason	string	Yes	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
NoticeType	integer	No	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
Dimensions	object []	No	The quota dimensions.
Key	string	No	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
Value	string	No	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
QuotaCategory	string	No	The type of the quota. CommonQuota (default value): general quota FlowControl: API rate limit WhiteListLabel: whitelist quota	CommonQuota
AuditMode	string	No	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
EnvLanguage	string	No	The language of the quota alert notification. Valid values: zh (default value): Chinese en: English	zh
ExpireTime	string	No	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
EffectiveTime	string	No	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

Parameter	Type	Description	Example
	object	None.
RequestId	string	The ID of the request.	D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053
Status	string	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
DesireValue	integer	The requested value of the quota.	12
QuotaActionCode	string	The ID of the quota.	ecs.c5.large
QuotaName	string	The name of the quota.	ecs.c5.large
ApplicationId	string	The ID of the application.	d314d6ae-867d-484c-9009-3d421a80****
Reason	string	The reason for the application.	Scale Out
AuditReason	string	The result of the application.	Agree
QuotaDescription	string	The description of the quota.	ecs.c5.large
ProductCode	string	The abbreviation of the Alibaba Cloud service name.	ecs-spec
QuotaArn	string	The Alibaba Cloud Resource Name (ARN) of the quota.	acs:quotas:cn-hangzhou:*:quota/ecs/ecs.m2.medium/prepaid/classic/instancetype/cn-hangzhou-b
ApplyTime	string	The time when the application was submitted.	2021-01-19T09:25:56Z
ApproveValue	float	The quota value that is approved.	804
Dimension	object	The quota dimension.	{"regionId":"cn-hangzhou"}
NoticeType	long	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
EffectiveTime	string	The time when the new quota value takes effect.	2021-01-19T09:25:56Z
ExpireTime	string	The time when the new quota expires.	2021-01-20T09:25:56Z
QuotaUnit	string	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 code	Error code	Error message	Description
400	ACQUIRE.LOCK.FAIL	The request is too frequent. Please try again later.	Too many attempts. Try again later.
400	InvalidNoticeType	Invalid NoticeType	The specified NoticeType parameter is invalid.
400	InvalidDesireValue	Invalid DesireValue	The specified DesireValue parameter is invalid.
400	QUOTA.NOT.ADJUSTABLE	Quota is not adjustable	The quota is not adjustable.
400	QUOTA.NOT.FOUND	The quota does not exist.	The quota does not exist.
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.
400	QUOTA.DESIREVALUE.ILLEGAL	The applied quota value is invalid.	The requested value is invalid.

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

Change history

Change time

Summary of changes

Operation

2023-09-22

API Description Update. The Error code has changed

see changesets

Change item	Change content
API Description	API Description Update.
Error Codes	The Error code has changed.
	delete Error Codes: 400