Help Center/ Elastic Cloud Server/ API Reference/ APIs (Recommended)/ Tenant Quota Management/ Querying Tenant Quotas
Updated on 2026-03-18 GMT+08:00
View PDF

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

Definition

Specifies the project ID.

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

Constraints

N/A

Range

N/A

Default Value

N/A

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

maxTotalSpotInstances

Integer

Definition

Specifies the maximum number of spot ECSs that can be requested.

Specifies ECSs billed in spot pricing billing mode. For details, see Spot Pricing (for Spot Instances).

Range

N/A

maxTotalSpotCores

Integer

Definition

Specifies the maximum number of vCPUs of spot ECSs that can be requested.

Range

N/A

maxTotalSpotRAMSize

Integer

Definition

Specifies the maximum memory size (MiB) of a spot ECS.

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

totalSpotInstancesUsed

Integer

Definition

Specifies the number of used spot ECSs.

Range

N/A

totalSpotCoresUsed

Integer

Definition

Specifies the number of used vCPUs of a spot ECS.

Range

N/A

totalSpotRAMUsed

Integer

Definition

Specifies the used memory size (MiB) of a spot ECS.

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

limit_by_flavor

Array of objects

Definition

This parameter is not used, and the returned value is [].

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
    }
}

Returned Values

See Returned Values for General Requests.

Error Codes

See Error Codes.

Parent topic: Tenant Quota Management