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