All Products
Search

This Product

    Quota Center:ListQuotaApplications

    Document Center

    Quota Center:ListQuotaApplications

    Last Updated:Aug 12, 2026

    Queries the list of quota increase applications.

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

    get

    *All Resource

    *

    		 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. Leave this parameter empty to query from the beginning.

    1
    MaxResults

    integer

    No

    The maximum number of records to return in this query.

    Valid values: 1 to 200. Default value: 30.

    1
    ProductCode

    string

    No

    The abbreviation of the cloud service name.

    csk
    QuotaActionCode

    string

    No

    The quota ID.

    q_i5uzm3
    Status

    string

    No

    The approval status of the quota increase application. Valid values:

    • Disagree: Rejected.

    • Agree: Approved.

    • Process: Under review.

    • Cancel: Closed.

    Valid values:

    • Cancel :

      Canceled.

    • Agree :

      Approved.

    • Process :

      Under review.

    • Disagree :

      Rejected.

    Agree
    KeyWord

    string

    No

    The keyword for searching quota increase applications.

    Cluster
    Dimensions

    array<object>

    No

    The quota dimensions. The dimensions are properties of a quota item. A combination of dimensions (Dimensions) and a quota ID (QuotaActionCode) uniquely identifies a quota item.

    Note

    Some cloud services require dimensions. You can call ListProductQuotaDimensions to query the quota dimensions supported by a cloud service. The Requisite response parameter indicates whether a dimension is required.

    object

    No

    The quota dimensions.

    Key

    string

    No

    The key of the quota dimension.

    Note

    Dimensions.N.Key and Dimensions.N.Value must be specified together. The valid values of N depend on the number of dimensions supported by the cloud service. You can call ListProductQuotaDimensions to query the quota dimensions supported by a cloud service. The length of the returned array is the value of N.

    regionId
    Value

    string

    No

    The value of the quota dimension.

    Note

    Dimensions.N.Key and Dimensions.N.Value must be specified together. The valid values of N depend on the number of dimensions supported by the cloud service. You can call ListProductQuotaDimensions to query the quota dimensions supported by a cloud service. The length of the returned array is the value of N.

    cn-hangzhou
    QuotaCategory

    string

    No

    The quota category. Valid values:

    • CommonQuota: general quota.

    • FlowControl: API rate limit.

    • WhiteListLabel: privilege.

    Valid values:

    • FlowControl :

      API rate limit.

    • WhiteListLabel :

      Privilege.

    • CommonQuota :

      General quota.

    CommonQuota

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    MaxResults

    integer

    The maximum number of records returned in this query.

    1
    NextToken

    string

    The token that marks the position of the returned data. An empty value indicates that all data has been returned.

    1
    QuotaApplications

    array<object>

    The details of the quota increase applications.

    array<object>

    The details of the quota increase applications.

    ApplicationId

    string

    The ID of the quota increase application.

    b926571d-cc09-4711-b547-58a615f0****
    ApplyTime

    string

    The time when the quota increase application was submitted. The value is in ISO 8601 format, in UTC, and ends with Z.

    2021-01-15T09:13:53Z
    ApproveValue

    number

    The approved quota value of the quota increase application.

    101
    AuditReason

    string

    The approval comment for the quota increase application.

    Agree
    Comment

    string

    The remarks of the quota increase application.

    test
    DesireValue

    number

    The requested quota value of the quota increase application.

    101
    Dimension

    object

    The quota dimensions of the quota increase application.

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

    string

    The effective period of the quota increase application. The value is in ISO 8601 format, in UTC, and ends with Z.

    2021-01-15T11:46:25Z
    ExpireTime

    string

    The expiration time of the quota increase application. The value is in ISO 8601 format, in UTC, and ends with Z.

    2021-01-17T11:46:25Z
    NoticeType

    integer

    Indicates whether a notification is sent for the quota increase application result. Valid values:

    • 0: No.

    • 3: Yes.

    3
    Period

    object

    The quota calculation period.

    PeriodUnit

    string

    The unit of the calculation period. Valid values:

    • second

    • minute

    • hour

    • day

    • week

    second
    PeriodValue

    integer

    The value of the calculation period.

    1
    ProductCode

    string

    The abbreviation of the cloud service name.

    csk
    QuotaActionCode

    string

    The quota ID.

    q_i5uzm3
    QuotaArn

    string

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

    acs:quotas:*:120886317861****:quota/csk/q_i5uzm3
    QuotaCategory

    string

    The quota category. Valid values:

    • CommonQuota (default): general quota.

    • WhiteListLabel: privilege.

    • 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 quota.

    Node
    Reason

    string

    The reason for the quota increase application.

    Business expansion
    Status

    string

    The approval status of the quota increase application. Valid values:

    • Disagree: Rejected.

    • Agree: Approved.

    • Process: Under review.

    • Cancel: Closed.

    Agree
    RequestId

    string

    The request ID.

    730925FB-0BD0-40AC-AF3A-A6C6E9716879
    TotalCount

    integer

    The total number of quota increase applications.

    1

    Examples

    Success response

    JSON format

    {
  "MaxResults": 1,
  "NextToken": "1",
  "QuotaApplications": [
    {
      "ApplicationId": "b926571d-cc09-4711-b547-58a615f0****",
      "ApplyTime": "2021-01-15T09:13:53Z",
      "ApproveValue": 101,
      "AuditReason": "Agree",
      "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.",
      "QuotaName": "Maximum Number of Nodes",
      "QuotaUnit": "Node",
      "Reason": "Business expansion",
      "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.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.