All Products
Search
Document Center

MaxCompute:UpdateComputeSubQuota

Last Updated:Jun 16, 2025

Updates the basic configuration of a MaxCompute quota. For example, you can call this operation to add or delete a level-2 quota, define the basic attributes of a level-2 quota, and define the configuration of compute units (CUs) for a quota plan that is in effect.

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:UpdateSubQuotasupdate
*Quota
acs:odps:{#regionId}:{#accountId}:quotas/{#NickName}
    none
none

Request syntax

PUT /api/v1/quotas/{nickname}/computeSubQuota HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
nicknamestringYes

The nickname of level-1 compute quota.

os_ComputeQuota_p
bodyobjectNo

The request body parameters.

subQuotaInfoListarray<object>No

The list of level-2 quotas.

objectNo

The list of level-2 quotas.

nickNamestringYes

The nickname of the level-2 quota.

os_ComputeQuota
parameterobjectNo

The parameters of the level-2 quota.

enablePrioritybooleanNo

Specifies whether to enable the priority feature.

false
forceReservedMinbooleanNo

Specifies whether the quota is strongly exclusive.

false
maxCUlongYes

The value of minCU in Reserved CUs.

Note The value of maxCU must be less than or equal to the value of maxCU in the level-1 quota that you purchased.
50
minCUlongYes

The value of maxCU in Reserved CUs.

Note
  • The total value of minCU in all the level-2 quotas is equal to the value of minCU in the level-1 quota.
  • The value of minCU must be less than or equal to the value of maxCU in the level-2 quota and less than or equal to the value of minCU in the level-1 quota that you purchased.
  • 50
    schedulerTypestringNo

    Scheduling policy of the quota.

    Fifo/Fair
    singleJobCULimitlongNo

    The upper limit for CUs that can be concurrently used by a job scheduled to the quota.

    10
    typestringNo

    The type of quota.

    Note
  • FUXI_OFFLINE(default) : Quotas of this type are used to run batch jobs.
  • FUXI_OFFLINE
    Danger
  • The configuration submitted by UpdateComputeSubQuota is the final form of Quota;

  • UpdateComputeSubQuota must be configured with the default level-2 quota;

  • When the input parameter contains a non-existent level-2 quota, a new level-2 quota will be created;

  • If an existing level-2 quota is not declared in the input parameter, it will be deleted;

  • If the configuration parameters of the existing level-2 quota are inconsistent, the configuration of the level-2 quota will be updated.

  • Response parameters

    ParameterTypeDescriptionExample
    object
    requestIdstring

    The ID of the request.

    0b57ff7616612271051086500ea3ce
    httpCodeinteger

    The HTTP status code.

    • 1xx: informational response. The request is received and is being processed.
    • 2xx: success. The request is successfully received, understood, and accepted by the server.
    • 3xx: redirection. The request is redirected, and further actions are required to complete the request.
    • 4xx: client error. The request contains invalid request parameters or syntaxes, or specific request conditions cannot be met.
    • 5xx: server error. The server cannot meet requirements due to other reasons.
    200
    errorCodestring

    The error code.

    OBJECT_NOT_EXIST
    errorMsgstring

    The error message.

    this quota is not exist.
    datastring

    The returned result.

    success

    Examples

    Sample success responses

    JSONformat

    {
      "requestId": "0b57ff7616612271051086500ea3ce",
      "httpCode": 200,
      "errorCode": "OBJECT_NOT_EXIST",
      "errorMsg": "this quota is not exist.",
      "data": "success"
    }

    Error codes

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