Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>

2023-10-11 08:28:11 +00:00

22 KiB

Raw Permalink Blame History

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

Parent topic: BMS Quota Management

22 KiB Raw Permalink Blame History