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.
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)
GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/limits
Response Parameters¶
Parameter | Type | Description |
|---|---|---|
absolute | Object | Specifies tenant quotas. For details, see Table 2. |
Note
Value -1 indicates that the quantity is unlimited.
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¶
{
"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.