All Products
Search
Document Center

MaxCompute:QueryQuota

Last Updated:Jun 16, 2025

Queries the information about a specified level-1 quota group.

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.

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:
    • For mandatory resource types, indicate with a prefix of * .
    • 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.
OperationAccess levelResource typeCondition keyAssociated operation
odps:QueryQuotaget
*Quota
acs:odps:{#regionId}:{#accountId}:quotas/{#NickName}
    none
none

Request syntax

GET /api/v1/quotas/{nickname}/query HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
nicknamestringYes

The quota name.

%E9%BB%98%E8%AE%A4%E9%A2%84%E4%BB%98%E8%B4%B9Quota_p # The Chinese name must be encoded and escaped by using UTF-8 URL encoding.
tenantIdstringNo

The tenant ID.

483212237127906
regionstringNo

The region ID.

cn-chengdu
AkProvenstringNo

The trusted AccessKey pairs.

null
mockbooleanNo

Specifies whether to include submodules. Valid values: true and false. -true: The request includes submodules. -false (default): The request does not include submodules.

false

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

requestIdstring

The request ID.

0bc1eeed16675342848904412e08dd
httpCodeinteger

The HTTP status code.

200
errorCodestring

The error code.

success
errorMsgstring

The error message.

Exception information
dataobject

The data returned.

subQuotaInfoListarray<object>

The level-2 quotas.

subQuotaInfoListobject

The returned data.

idstring

The ID of the level-2 quota.

1000048
namestring

The name of the level-2 quota.

subquotaA
nickNamestring

The nickname of the level-2 quota.

subquotaA
typestring

This parameter corresponds to the resourceSystemType field.

FUXI_ONLINE
statusstring

The status of the resource.

ON
tenantIdstring

The tenant ID.

478403690625249
regionIdstring

The region ID.

cn-beijing
parentIdstring

The parent resource ID.

0
clusterstring

The cluster ID.

AT-120N
versionstring

The version number.

1
billingPolicyobject

The order information.

odpsSpecCodestring

The order specifications.

OdpsStandard
orderIdstring

The order ID.

880c0d0d-5d79-4217-b683-8e8bdd2a2523
instanceIdstring

In MaxCompute, instanceId and orderId are considered the same.

880c0d0d-5d79-4217-b683-8e8bdd2a2523
billingMethodstring

The billing method. Valid values:

  • subscription: the subscription quota.
  • payasyougo: the pay-as-you-go quota.
subscription
scheduleInfoobject

The information about the scheduling plan.

currPlanstring

The current quota plan that has taken effect based on the scheduling plan.

planA
currTimestring

The time when the plan specified by currPlan is scheduled.

0800
nextPlanstring

The quota plan that will take effect based on the scheduling plan.

planB
nextTimestring

The time when the plan specified by nextPlan is scheduled.

1700
oncePlanstring

The quota plan that immediately takes effect. If the quota plan specified by this parameter is triggered and the plan is different from the plan specified by currPlan, this parameter is not empty.

planC
onceTimestring

The time when the quota plan specified by oncePlan is scheduled.

1500
operatorNamestring

The operator name.

userA
timezonestring

The time zone of the project.

UTC+8
parameterobject

The quota description.

{'maxCU': 10, 'minCU': 10, 'adhocCU': 0, 'schedulerType': 'Fifo'}
tagstring

The resource tag of a quota.

abc
createTimelong

The time when the resource was created.

1688653978768
creatorIdstring

The ID of the Alibaba Cloud account that is used to create the quota plan.

672863518
groupNamestring

The role group name.

abc
saleTagobject

The identifiers of MaxCompute quota objects. The identifiers are the same as those in the Alibaba Cloud sales bill. This parameter is used for tags.

resourceIdsarray

The identifier of a MaxCompute quota object. This identifier exists in the Alibaba Cloud sales bill. You can use this identifier to associate the cost of a quota object with a tag.

resourceIdstring

The identifier of a MaxCompute quota object. This identifier exists in the Alibaba Cloud sales bill. You can use this identifier to associate the cost of a quota object with a tag.

"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceTypestring

The object type. Valid values: quota and project.

"quota"
idstring

The quota ID.

2523
namestring

The quota name.

quota_a
nickNamestring

The quota alias.

quota_nickname
typestring

This parameter corresponds to the resourceSystemType field.

FUXI_OFFLINE
statusstring

The status of the resource.

ON
tenantIdstring

The tenant ID.

478403690625249
regionIdstring

The region ID.

cn-beijing
parentIdstring

The parent resource ID.

null
clusterstring

The ID of the Managed Service for Prometheus cluster.

AT-120N
versionstring

The version number.

1
billingPolicyobject

The order information.

odpsSpecCodestring

The order specifications.

OdpsStandard
orderIdstring

The order ID.

880c0d0d-5d79-4217-b683-8e8bdd2a2523
instanceIdstring

In MaxCompute, instanceId and orderId are considered the same.

880c0d0d-5d79-4217-b683-8e8bdd2a2523
billingMethodstring

The billing method. Valid values:

  • subscription: the subscription quota.
  • payasyougo: the pay-as-you-go quota.
subscription
scheduleInfoobject

The information about the scheduling plan.

currPlanstring

The current quota plan that has taken effect based on the scheduling plan.

planA
currTimestring

The time when the plan specified by currPlan is scheduled.

0800
nextPlanstring

The quota plan that will take effect based on the scheduling plan.

planB
nextTimestring

The time when the plan specified by nextPlan is scheduled.

1700
oncePlanstring

The quota plan that immediately takes effect. If the quota plan specified by this parameter is triggered and the plan is different from the plan specified by currPlan, this parameter is not empty.

planC
onceTimestring

The time when the quota plan specified by oncePlan is scheduled.

1500
operatorNamestring

The operator name.

userA
timezonestring

The time zone of the project.

UTC+8
parameterobject

The quota description.

{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
tagstring

The resource tag of a quota.

abc
createTimelong

The time when the resource was created.

1714356241163
creatorIdstring

The ID of the Alibaba Cloud account that is used to create the quota plan.

1248953767546358
groupNamestring

The group name.

abc
saleTagobject

The identifiers of MaxCompute quota objects. The identifiers are the same as those in the Alibaba Cloud sales bill. This parameter is used for tags.

resourceIdsarray

The identifier of a MaxCompute quota object. This identifier exists in the Alibaba Cloud sales bill. You can use this identifier to associate the cost of a quota object with a tag.

resourceIdstring

The identifier of a MaxCompute quota object. This identifier exists in the Alibaba Cloud sales bill. You can use this identifier to associate the cost of a quota object with a tag.

"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceTypestring

The object type. Valid values: quota and project.

project

Examples

Sample success responses

JSONformat

{
  "requestId": "0bc1eeed16675342848904412e08dd",
  "httpCode": 200,
  "errorCode": "success",
  "errorMsg": "Exception information",
  "data": {
    "subQuotaInfoList": [
      {
        "id": 1000048,
        "name": "subquotaA",
        "nickName": "subquotaA",
        "type": "FUXI_ONLINE",
        "status": "ON",
        "tenantId": 478403690625249,
        "regionId": "cn-beijing",
        "parentId": 0,
        "cluster": "AT-120N\n",
        "version": 1,
        "billingPolicy": {
          "odpsSpecCode": "OdpsStandard",
          "orderId": "880c0d0d-5d79-4217-b683-8e8bdd2a2523",
          "instanceId": "880c0d0d-5d79-4217-b683-8e8bdd2a2523",
          "billingMethod": "subscription"
        },
        "scheduleInfo": {
          "currPlan": "planA",
          "currTime": "0800",
          "nextPlan": "planB",
          "nextTime": 1700,
          "oncePlan": "planC",
          "onceTime": 1500,
          "operatorName": "userA",
          "timezone": "UTC+8"
        },
        "parameter": {
          "test": "test",
          "test2": 1
        },
        "tag": "abc",
        "createTime": 1688653978768,
        "creatorId": 672863518,
        "groupName": "abc",
        "saleTag": {
          "resourceIds": [
            "aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
          ],
          "resourceType": "quota"
        }
      }
    ],
    "id": 2523,
    "name": "quota_a",
    "nickName": "quota_nickname",
    "type": "FUXI_OFFLINE",
    "status": "ON",
    "tenantId": 478403690625249,
    "regionId": "cn-beijing",
    "parentId": null,
    "cluster": "AT-120N",
    "version": 1,
    "billingPolicy": {
      "odpsSpecCode": "OdpsStandard",
      "orderId": "880c0d0d-5d79-4217-b683-8e8bdd2a2523",
      "instanceId": "880c0d0d-5d79-4217-b683-8e8bdd2a2523",
      "billingMethod": "subscription"
    },
    "scheduleInfo": {
      "currPlan": "planA",
      "currTime": "0800",
      "nextPlan": "planB",
      "nextTime": 1700,
      "oncePlan": "planC",
      "onceTime": 1500,
      "operatorName": "userA",
      "timezone": "UTC+8"
    },
    "parameter": {
      "test": "test",
      "test2": 1
    },
    "tag": "abc",
    "createTime": 1714356241163,
    "creatorId": 1248953767546358,
    "groupName": "abc",
    "saleTag": {
      "resourceIds": [
        "aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
      ],
      "resourceType": "project"
    }
  }
}

Error codes

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

Change history

Change timeSummary of changesOperation
No change history