ListQuotaApplications - Quota Center - Alibaba Cloud Documentation Center

Queries the details of an application that is submitted to increase a quota.

Operation description

In this example, the operation is called to query the details of an application that is submitted to increase a quota whose ID is q_i5uzm3 and whose name is Maximum Number of Nodes. This quota belongs to Container Service for Kubernetes (ACK). The query result shows the details of the application. The details include the application ID, application time, requested quota, and application result. In this example, the application ID is b926571d-cc09-4711-b547-58a615f0****. The application time is 2021-01-15T09:13:53Z. The expected quota value is 101. The application result is Agree.

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.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
quotas:ListQuotaApplications	get	All Resources *	none	none

Request parameters

Parameter	Type	Required	Description	Example
NextToken	string	No	The token that marks the position from which you want to start the query. If you leave this parameter empty, the query starts from the beginning.	1
MaxResults	integer	No	The maximum number of entries to return. Valid values: 1 to 200. Default value: 30.	1
ProductCode	string	No	The abbreviation of the Alibaba Cloud service name.	csk
QuotaActionCode	string	No	The ID of the quota.	q_i5uzm3
Status	string	No	The approval state of the quota increase application. Valid values: Disagree: The application is rejected. Agree: The application is approved. Process: The application is in review. Cancel: The application is canceled.	Agree
KeyWord	string	No	The keyword that you want to use to search for the application.	Cluster
Dimensions	array<object>	No	The quota dimensions.
	object	No	The quota dimension.
Key	string	No	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.	regionId
Value	string	No	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.	cn-hangzhou
QuotaCategory	string	No	The quota type. Valid values: CommonQuota: general quota. FlowControl: API rate limit. WhiteListLabel: whitelist quota.	CommonQuota

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

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
MaxResults	integer	The maximum number of records that are returned for the query.	1
NextToken	string	The token that marks the position at which the query ends. An empty value indicates that all data is returned.	1
QuotaApplications	array<object>	The details of the quota increase applications.
QuotaApplications	object	The details of a quota increase application.
ApplicationId	string	The ID of the application.	b926571d-cc09-4711-b547-58a615f0****
ApplyTime	string	The time when the application was submitted.	2021-01-15T09:13:53Z
ApproveValue	float	The quota value that is approved.	101
AuditReason	string	The result of the application.	Agree
Comment	string	The remarks of the application.	test
DesireValue	float	The quota value that is approved.	101
Dimension	object	The dimension of the application.	{"regionId":"cn-hangzhou"}
EffectiveTime	string	The time when the application took effect.	2021-01-15T11:46:25Z
ExpireTime	string	The time when the application expired.	2021-01-17T11:46:25Z
NoticeType	integer	Indicates whether Quota Center sends a notification about the application result. Valid values: 0: A notification about the application result is not sent. 3: A notification about the application result is sent.	3
Period	object	The calculation cycle of the quota.
PeriodUnit	string	The unit of the calculation cycle. Valid values: second minute hour day week	second
PeriodValue	long	The value of the calculation cycle.	1
ProductCode	string	The abbreviation of the Alibaba Cloud service name.	csk
QuotaActionCode	string	The ID of the quota.	q_i5uzm3
QuotaArn	string	The Alibaba Cloud Resource Name (ARN) of the quota.	acs:quotas::120886317861***:quota/csk/q_i5uzm3
QuotaCategory	string	The quota type. Valid values: CommonQuota (default): general quota. WhiteListLabel: whitelist quota. FlowControl: API rate limit.	CommonQuota
QuotaDescription	string	The description of the quota.	The maximum number of nodes in a cluster
QuotaName	string	The name of the quota.	Maximum Number of Nodes
QuotaUnit	string	The unit of the new quota value.	Node
Reason	string	The reason for the application.	Business expansion
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.	Agree
RequestId	string	The ID of the request.	730925FB-0BD0-40AC-AF3A-A6C6E9716879
TotalCount	integer	The total number of applications.	1

Examples

Sample success responses

JSONformat

{
  "MaxResults": 1,
  "NextToken": "1",
  "QuotaApplications": [
    {
      "ApplicationId": "b926571d-cc09-4711-b547-58a615f0****",
      "ApplyTime": "2021-01-15T09:13:53Z",
      "ApproveValue": 101,
      "AuditReason": "Agree\n",
      "Comment": "test",
      "DesireValue": 101,
      "Dimension": {
        "regionId": "cn-hangzhou"
      },
      "EffectiveTime": "2021-01-15T11:46:25Z",
      "ExpireTime": "2021-01-17T11:46:25Z",
      "NoticeType": 3,
      "Period": {
        "PeriodUnit": "second",
        "PeriodValue": 1
      },
      "ProductCode": "csk",
      "QuotaActionCode": "q_i5uzm3",
      "QuotaArn": "acs:quotas:*:120886317861****:quota/csk/q_i5uzm3",
      "QuotaCategory": "CommonQuota",
      "QuotaDescription": "The maximum number of nodes in a cluster\n",
      "QuotaName": "Maximum Number of Nodes\n",
      "QuotaUnit": "Node",
      "Reason": "Business expansion\n",
      "Status": "Agree"
    }
  ],
  "RequestId": "730925FB-0BD0-40AC-AF3A-A6C6E9716879",
  "TotalCount": 1
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidStatus	Invalid Status	The specified Status parameter is invalid.

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

Change history

Change time	Summary of changes	Operation
2024-01-16	The Error code has changed. The request parameters of the API has changed	View Change Details
2024-01-12	The Error code has changed. The request parameters of the API has changed	View Change Details
2023-09-22	API Description Update. The Error code has changed	View Change Details