• Native OpenStack API

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

Querying Tenant Quota Limits

Function Description

This interface is used to query tenant quota limits.

Tenants are only allowed to query their own quota limits.

URI

  • URI format

    GET /v2/{tenant_id}/limits?tenant_id={tenant_id}

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

  • Parameter description

    Parameter

    Type

    Mandatory

    Description

    tenant_id

    String

    Yes

    Specifies the tenant or project ID.

Restrictions

N/A

Extension Description

N/A

Request

N/A

Response

Parameter

Type

Mandatory

Description

limits

Dict

Yes

Specifies tenant limits.

Table 1 limits parameter information

Parameter

Type

Mandatory

Description

rate

List

Yes

The value is empty.

absolute

Dict

Yes

Specifies the tenant quota limits.

Table 2 absolute parameter information

Parameter

Type

Mandatory

Description

maxServerMeta

String

Yes

Specifies the limit of ECS metadata quantity.

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

maxPersonality

String

Yes

Specifies the quantity limit of injected files.

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

totalServerGroupsUsed

String

Yes

Specifies the number of used ECS groups.

maxImageMeta

String

Yes

Specifies the limit of the image metadata quantity.

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

maxPersonalitySize

String

Yes

Specifies the size limit of injected files.

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

maxTotalRAMSize

String

Yes

Specifies the total memory size limit.

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

maxTotalKeypairs

String

Yes

Specifies the limit of key pair quantity.

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

maxSecurityGroupRules

String

Yes

Specifies the maximum number of security group rules.

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

maxServerGroups

String

Yes

Specifies the maximum number of ECS groups.

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

totalCoresUsed

String

Yes

Specifies the number of used cores.

totalRAMUsed

String

Yes

Specifies the size of used memory.

maxSecurityGroups

String

Yes

Specifies the maximum number of security groups.

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

totalFloatingIpsUsed

String

Yes

Specifies the number of used floating IP addresses.

totalInstancesUsed

String

Yes

Specifies the number of used ECSs.

totalSecurityGroupsUsed

String

Yes

Specifies the number of used security groups.

maxTotalFloatingIps

String

Yes

Specifies the maximum number of floating IP addresses.

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

maxTotalInstances

String

Yes

Specifies the maximum number of ECSs.

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

maxTotalCores

String

Yes

Specifies the maximum number of cores.

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

maxServerGroupMembers

String

Yes

Specifies the maximum number of members in an ECS group.

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

Request Example

GET /v2/d9ebe43510414ef590a4aa158605329e/limits

GET /v2.1/d9ebe43510414ef590a4aa158605329e/limits

Response Example

{
  "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.