Updated on 2024-04-16 GMT+08:00

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}

Table 1 describes the parameters in the URI.
Table 1 Parameter description

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.

Table 2 Response parameters

Parameter

Type

Description

quota_set

Object

Specifies the quota_set object. For details, see Table 3.

Table 3 quota_set parameter description

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.

floating_ips

Integer

Specifies the quantity quota of floating IP addresses. This parameter is not supported.

id

String

Specifies the project UUID.

injected_file_content_bytes

Integer

Specifies the size quota (bytes) of the files to be injected.

injected_file_path_bytes

Integer

Specifies the size quota (bytes) of the path for the files to be injected.

injected_files

Integer

Specifies the quantity quota of the files to be injected.

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.

security_groups

Integer

Specifies the quantity quota of security groups. This parameter is not supported.

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