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
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
Parameter |
Type |
Description |
---|---|---|
absolute |
Object |
Definition Specifies tenant quotas. For details, see Table 3. Range N/A |
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
{ "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
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.