Updated on 2025-08-20 GMT+08:00

Querying Tenant Quotas

Function

This API is used to query the quotas of all resources for a specified tenant, including used quotas.

URI

GET /v1/{project_id}/cloudservers/limits

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the ID, see Obtaining a Project ID.

Request

None

Response

Table 2 describes the response parameters.
Table 2 Response parameters

Parameter

Type

Description

absolute

Object

Definition

Specifies tenant quotas. For details, see Table 3.

Range

N/A

Table 3 absolute field description

Parameter

Type

Description

maxTotalInstances

Integer

Definition

Specifies the maximum number of ECSs that can be requested.

Range

N/A

maxTotalCores

Integer

Definition

Specifies the maximum number of CPU cores that the current tenant can apply for.

Range

N/A

maxTotalRAMSize

Integer

Definition

Specifies the maximum memory size (MiB) allowed.

Range

N/A

maxTotalKeypairs

Integer

Definition

Specifies the maximum number of SSH key pairs you can use.

Range

N/A

maxServerMeta

Integer

Definition

Specifies the maximum length of the metadata you can use.

Range

N/A

maxPersonality

Integer

Definition

Specifies the maximum number of files that can be injected.

Range

N/A

maxPersonalitySize

Integer

Definition

Specifies the maximum size (byte) of the file to be injected.

Range

N/A

maxServerGroups

Integer

Definition

Specifies the maximum number of server groups.

Range

N/A

maxServerGroupMembers

Integer

Definition

Specifies the maximum number of ECSs in an ECS group.

Range

N/A

totalServerGroupsUsed

Integer

Definition

Specifies the number of used server groups.

Range

N/A

maxSecurityGroups

Integer

Definition

Specifies the maximum number of security groups you can use.

NOTE:

The quota complies with the VPC quota limit.

Range

N/A

maxSecurityGroupRules

Integer

Definition

Specifies the maximum number of security group rules that you can configure in a security group.

NOTE:

The quota complies with the VPC quota limit.

Range

N/A

maxTotalFloatingIps

Integer

Definition

Specifies the maximum number of floating IP addresses you can use.

Range

N/A

maxImageMeta

Integer

Definition

Specifies the maximum length of the image metadata.

Range

N/A

totalInstancesUsed

Integer

Definition

Specifies the number of used ECSs.

Range

N/A

totalCoresUsed

Integer

Definition

Specifies the number of the used CPU cores.

Range

N/A

totalRAMUsed

Integer

Definition

Specifies the used memory size (MiB).

Range

N/A

totalSecurityGroupsUsed

Integer

Definition

Specifies the number of used security groups.

Range

N/A

totalFloatingIpsUsed

Integer

Definition

Specifies the number of used floating IP addresses.

Range

N/A

Example Request

Query the quotas of all resources in a project for a tenant.

GET https://{endpoint}/v1/{project_id}/cloudservers/limits

Example Response

Example response
{
    "absolute":{
        "maxServerMeta":128,
        "maxPersonality":5,
        "maxImageMeta":128,
        "maxPersonalitySize":10240,
        "maxSecurityGroupRules":20,
        "maxTotalKeypairs":-1,
        "totalRAMUsed":75776,
        "totalInstancesUsed":21,
        "maxSecurityGroups":10,
        "totalFloatingIpsUsed":0,
        "maxTotalCores":20480,
        "totalSecurityGroupsUsed":1,
        "maxTotalFloatingIps":10,
        "maxTotalInstances":2048,
        "totalCoresUsed":40,
        "maxTotalRAMSize":25165824,
        "maxServerGroups":10,
        "maxServerGroupMembers":16,
        "totalServerGroupsUsed":2
    }
}

Error Codes

See Error Codes.