• Elastic Cloud Server

ecs
  1. Help Center
  2. Elastic Cloud Server
  3. API Reference
  4. Extension ECS APIs
  5. Tenant Quota Management
  6. Querying Tenant Quotas

Querying Tenant Quotas

Function Description

This interface 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.

Request

N/A

Response

Response parameters

Table 2 describes the response parameters.
Table 2 Response parameters

Parameter

Type

Description

absolute

Dictionary data structure

Specifies tenant quotas. For details, see Table 3.

Table 3 absolute field description

Parameter

Type

Description

maxTotalInstances

Integer

Specifies the maximum number of ECSs you can use.

maxTotalCores

Integer

Specifies the maximum number of CPU cores you can use.

maxTotalRAMSize

Integer

Specifies the maximum memory space (MB) you can use.

maxTotalKeypairs

Integer

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

maxServerMeta

Integer

Specifies the maximum length of the metadata you can use.

maxPersonality

Integer

Specifies the maximum number of files that can be injected.

maxPersonalitySize

Integer

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

maxServerGroups

Integer

Specifies the maximum number of server groups.

maxServerGroupMembers

Integer

Specifies the maximum number of ECSs in an ECS group.

totalServerGroupsUsed

Integer

Specifies the number of used server groups.

maxSecurityGroups

Integer

Specifies the maximum number of security groups you can use.

NOTE:

The quota complies with the VPC quota limit.

maxSecurityGroupRules

Integer

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.

maxTotalFloatingIps

Integer

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

maxImageMeta

Integer

Specifies the maximum length of the image metadata.

totalInstancesUsed

Integer

Specifies the number of the used ECSs.

totalCoresUsed

Integer

Specifies the number of the used CPU cores.

totalRAMUsed

Integer

Specifies the used memory size (MB).

totalSecurityGroupsUsed

Integer

Specifies the number of used security groups.

totalFloatingIpsUsed

Integer

Specifies the number of used floating IP addresses.

Examples

  • 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 General Request Returned Values.

Error Code

See Error Code Description.