• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Nova
  5. Tenant Quota Management
  6. Querying Tenant Quota Limits

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?tenant_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

N/A

Response

Response parameters

Table 2 describes the response parameters.

Table 2 Response parameters

Parameter

Type

Description

limits

Dict

Specifies tenant limits.

Table 3 limits parameter information

Parameter

Type

Description

rate

List

The value is empty.

absolute

Dict

Specifies the tenant quota limits.

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 field is not supported in microversions later than 2.56.

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 field is not supported in microversions later than 2.38.

maxPersonalitySize

String

Specifies the size limit of injected files.

If the value is -1, there is no size limit.

This field is not supported in microversions later than 2.56.

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 field is not supported in microversions later than 2.35.

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 field is not supported in microversions later than 2.35.

totalFloatingIpsUsed

String

Specifies the number of used floating IP addresses.

This field is not supported in microversions later than 2.35.

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 field is not supported in microversions later than 2.35.

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.

Examples

  • Example request
    GET /v2/d9ebe43510414ef590a4aa158605329e/limits
    GET /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 General Request Returned Values.