Querying Tenant Quota Limits¶

Function¶

This API is used to query tenant quota limits.

Tenants are only allowed to query their own quota limits.

URI¶

GET /v2.1/{project_id}/limits?project_id={project_id}

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
limits	Object	Specifies tenant limits. For details, see Table 3.

**Table 3** **limits** parameter information¶
Parameter	Type	Description
rate	List	The value is empty.
absolute	Object	Specifies tenant quota limits. For details, see Table 4.

**Table 4** **absolute** parameter information¶
Parameter	Type	Description
maxServerMeta	String	Specifies the limit of ECS metadata quantity. If the value is -1, there is no quantity limit.
maxPersonality	String	Specifies the quantity limit of injected files. If the value is -1, there is no quantity limit.
totalServerGroupsUsed	String	Specifies the number of used ECS groups.
maxImageMeta	String	Specifies the limit of the image metadata quantity. If the value is -1, there is no quantity limit.
maxPersonalitySize	String	Specifies the size limit of injected files. If the value is -1, there is no size limit.
maxTotalRAMSize	String	Specifies the total memory size limit. If the value is -1, there is no size limit.
maxTotalKeypairs	String	Specifies the limit of key pair quantity. If the value is -1, there is no quantity limit.
maxSecurityGroupRules	String	Specifies the maximum number of security group rules. If the value is -1, there is no quantity limit. This parameter is not supported in microversion 2.35 and later.
maxServerGroups	String	Specifies the maximum number of ECS groups. If the value is -1, there is no quantity limit.
totalCoresUsed	String	Specifies the number of used cores.
totalRAMUsed	String	Specifies the size of used memory.
maxSecurityGroups	String	Specifies the maximum number of security groups. If the value is -1, there is no quantity limit.
totalFloatingIpsUsed	String	Specifies the number of used floating IP addresses.
totalInstancesUsed	String	Specifies the number of used ECSs.
totalSecurityGroupsUsed	String	Specifies the number of used security groups.
maxTotalFloatingIps	String	Specifies the maximum number of floating IP addresses. If the value is -1, there is no quantity limit.
maxTotalInstances	String	Specifies the maximum number of ECSs. If the value is -1, there is no quantity limit.
maxTotalCores	String	Specifies the maximum number of cores. If the value is -1, there is no quantity limit.
maxServerGroupMembers	String	Specifies the maximum number of members in an ECS group. If the value is -1, there is no quantity limit.

Example Request¶

Query tenant quota limits.

GET https://{endpoint}/v2.1/d9ebe43510414ef590a4aa158605329e/limits

Example Response¶

{
  "limits": {
    "rate": [],
    "absolute": {
      "maxServerMeta": 128,
      "maxPersonality": 5,
      "totalServerGroupsUsed": 0,
      "maxImageMeta": 128,
      "maxPersonalitySize": 10240,
      "maxTotalRAMSize": 25165824,
      "maxTotalKeypairs": -1,
      "maxSecurityGroupRules": 20,
      "maxServerGroups": -1,
      "totalCoresUsed": 0,
      "totalRAMUsed": 0,
      "maxSecurityGroups": 10,
      "totalFloatingIpsUsed": 0,
      "totalInstancesUsed": 0,
      "totalSecurityGroupsUsed": 0,
      "maxTotalFloatingIps": 10,
      "maxTotalInstances": 2048,
      "maxTotalCores": 20480,
      "maxServerGroupMembers": -1
    }
  }
}

Returned Values¶

See Returned Values for General Requests.

last updated: 2024-11-08 14:21 UTC - commit: c986e0f7c0392c4cd98c9cb56ea7f6b22cacb972