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

GET /v2/{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.

#### 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. This parameter is not supported in microversion 2.56 and later.
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. This parameter is not supported in microversion 2.38 and later.
maxPersonalitySize | String | Specifies the size limit of injected files. If the value is -1, there is no size limit. This parameter is not supported in microversion 2.56 and later.
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. This parameter is not supported in microversion 2.35 and later.
totalFloatingIpsUsed | String | Specifies the number of used floating IP addresses. This parameter is not supported in microversion 2.35 and later.
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. This parameter is not supported in microversion 2.35 and later.
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

    GET https://{endpoint}/v2/d9ebe43510414ef590a4aa158605329e/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.

Parent topic: Tenant Quota Management