Querying Tenant Quotas¶
Function¶
This API is used to query quotas, including ECSs, vCPUs, and memory.
This API provides the user_id parameter for obtaining the quota configuration of a specified user.
URI¶
GET /v2.1/{project_id}/os-quota-sets/{project_id}?user_id={user_id}
GET /v2/{project_id}/os-quota-sets/{project_id}?user_id={user_id}
Table 1 describes the parameters in the URI.
Parameter | Mandatory | Description |
|---|---|---|
project_id | Yes | Specifies the project ID. If the specified project does not exist, the default quota in the system is returned. |
user_id | No | Specifies the user ID. If the specified user does not exist, the default quota in the system is returned. |
Request¶
None
Response¶
Table 2 describes the response parameters.
Parameter | Type | Description |
|---|---|---|
quota_set | Object | Specifies the quota_set object. For details, see Table 3. |
Parameter | Type | Description |
|---|---|---|
cores | Integer | Specifies the quantity quota of vCPUs. |
fixed_ips | Integer | Specifies the quantity quota of fixed IP addresses. This parameter is not supported. This parameter is not supported in microversion 2.36 and later. |
floating_ips | Integer | Specifies the quantity quota of floating IP addresses. This parameter is not supported. This parameter is not supported in microversion 2.36 and later. |
id | String | Specifies the project UUID. |
injected_file_content_bytes | Integer | Specifies the size quota (bytes) of the files to be injected. This parameter is not supported in microversion 2.56 and later. |
injected_file_path_bytes | Integer | Specifies the size quota (bytes) of the path for the files to be injected. This parameter is not supported in microversion 2.56 and later. |
injected_files | Integer | Specifies the quantity quota of the files to be injected. This parameter is not supported in microversion 2.56 and later. |
instances | Integer | Specifies the quantity quota of ECSs. |
key_pairs | Integer | Specifies the quantity quota of key pairs. This parameter is not supported. |
metadata_items | Integer | Specifies the metadata quantity quota. |
ram | Integer | Specifies the memory quota (MB). |
security_group_rules | Integer | Specifies the quota of security group rules. This parameter is not supported. This parameter is not supported in microversion 2.36 and later. |
security_groups | Integer | Specifies the quantity quota of security groups. This parameter is not supported. This parameter is not supported in microversion 2.36 and later. |
server_groups | Integer | Specifies the quantity quota of ECS groups. |
server_group_members | Integer | Specifies the ECS quota in an ECS group. |
Example Request¶
Query quotas of resources such as ECSs, vCPUs, and memory.
GET https://{endpoint}/v2/d9ebe43510414ef590a4aa158605329e/os-quota-sets/d9ebe43510414ef590a4aa158605329e
GET https://{endpoint}/v2.1/d9ebe43510414ef590a4aa158605329e/os-quota-sets/d9ebe43510414ef590a4aa158605329e
Example Response¶
{
"quota_set": {
"cores": 20,
"fixed_ips": 40,
"floating_ips": 10,
"id": "d9ebe43510414ef590a4aa158605329e",
"injected_file_content_bytes": 10240,
"injected_file_path_bytes": 255,
"injected_files": 5,
"instances": 20,
"key_pairs": 100,
"metadata_items": 128,
"ram": 51200,
"security_group_rules": 20,
"security_groups": 50,
"server_group_members": 10,
"server_groups": 10
}
}