Help Center> Bare Metal Server> API Reference> BMS APIs> BMS Quota Management> Querying Tenant Quotas
View PDF

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}/baremetalservers/limits

Table 1 lists the URI parameters.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the project ID, see Obtaining a Project ID.

Request

  • Request parameters

    None

  • Example request 
    1
    		 
    GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/limits

Response

  • Response parameters

    Parameter

    Type

    Description

    absolute

    Object

    Specifies tenant quotas. For details, see Table 2.

    Value -1 indicates that the quantity is unlimited.

    Table 2 absolute field data structure description

    Parameter

    Type

    Description

    maxTotalInstances

    Integer

    Specifies the maximum number of BMSs you can use.

    maxTotalCores

    Integer

    Specifies the maximum number of CPUs you can use.

    maxTotalRAMSize

    Integer

    Specifies the maximum memory (MB) you can use.

    maxTotalKeypairs

    Integer

    Specifies the maximum number of SSH key pairs you can use.

    maxServerMeta

    Integer

    Specifies the maximum length of the metadata you can use.

    maxPersonality

    Integer

    Specifies the maximum number of files that can be injected.

    maxPersonalitySize

    Integer

    Specifies the maximum size (byte) of the file to be injected.

    maxServerGroups

    Integer

    Specifies the maximum number of server groups.

    maxServerGroupMembers

    Integer

    Specifies the maximum number of BMSs in a server group.

    totalServerGroupsUsed

    Integer

    Specifies the number of used server groups.

    maxSecurityGroups

    Integer

    Specifies the maximum number of security groups you can use.

    NOTE:

    The quota limit complies with the VPC quota limit.

    maxSecurityGroupRules

    Integer

    Specifies the maximum number of security group rules that you can configure in a security group.

    NOTE:

    The quota limit complies with the VPC quota limit.

    maxTotalFloatingIps

    Integer

    Specifies the maximum number of EIPs you can use.

    maxImageMeta

    Integer

    Specifies the maximum length of the image metadata.

    totalInstancesUsed

    Integer

    Specifies the number of the used BMSs.

    totalCoresUsed

    Integer

    Specifies the number of used CPUs.

    totalRAMUsed

    Integer

    Specifies the used memory (MB).

    totalSecurityGroupsUsed

    Integer

    Specifies the number of used security groups.

    totalFloatingIpsUsed

    Integer

    Specifies the number of used EIPs.
  • Example response 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
    		 
    {
    "absolute": {
        "maxServerMeta": 128,
        "maxPersonality": 5,
        "maxImageMeta": 128,
        "maxPersonalitySize": 10240,
        "maxSecurityGroupRules": 20,
        "maxTotalKeypairs": 100,
        "totalRAMUsed": 799836,
        "totalInstancesUsed": 21,
        "maxSecurityGroups": 10,
        "totalFloatingIpsUsed": 0,
        "maxTotalCores": -1,
        "totalSecurityGroupsUsed": 1,
        "maxTotalFloatingIps": 10,
        "maxTotalInstances": 100,
        "totalCoresUsed": 148,
        "maxTotalRAMSize": -1,
        "maxServerGroups": -1,
        "maxServerGroupMembers": -1,
        "totalServerGroupsUsed": 1
    }
}

Returned Values

Normal values

Returned Values

Description

200

The server has successfully processed the request.

For details about other returned values, see Status Codes.

Error Codes

See Error Codes.

Parent topic: BMS Quota Management