Updated on 2026-09-30 GMT+08:00

Querying Resource Quotas

Function

This API is used to query CCE resource quotas.

Calling Method

For details, see Calling APIs.

URI

GET /api/v3/projects/{project_id}/quotas

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Details:

Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI.

Constraints:

None

Options:

Project IDs of the account

Default value:

N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Definition:

Type (or format) of the request body. The default value is application/json. Other values of this field will be provided for specific APIs, if any.

Constraints:

GET requests are not validated.

Range:

N/A

Default Value:

N/A

X-Auth-Token

Yes

String

Details:

Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token.

Constraints:

None

Options:

N/A

Default value:

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

quotas

Array of QuotaResource objects

Definition:

Resource quota list

Range:

N/A

Table 4 QuotaResource

Parameter

Type

Description

quotaKey

String

Definition:

Resource type.

Range:

  • cluster: cluster quota

quotaLimit

Integer

Definition:

Resource quota

Range:

N/A

used

Integer

Definition:

Number of created resources

Range:

N/A

unit

String

Definition:

Resource unit

Range:

  • count

regionId

String

Definition:

Region ID. This parameter is not returned if not involved.

Range:

N/A

availabilityZoneId

String

Definition:

AZ ID. This parameter is not returned if not involved.

Range:

N/A

Example Requests

None

Example Responses

Status code: 200

{
  "quotas" : [ {
    "quotaKey" : "cluster",
    "quotaLimit" : 20,
    "used" : 13,
    "unit" : "count"
  } ]
}

Status Codes

Status Code

Description

200

The resource quotas are obtained successfully.

Error Codes

See Error Codes.