Updated on 2024-08-09 GMT+08:00

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 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 Parameters

None

Example Request

Querying the quotas of a tenant (project ID: bbf1946d374b44a0a2a95533562ba954)
1
GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/limits

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 create.

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 request has been successfully processed.

For details about other returned values, see Status Codes.

Error Codes

See Error Codes.