• Elastic Cloud Server

ecs
  1. Help Center
  2. Elastic Cloud Server
  3. API Reference
  4. OpenStack Nova APIs
  5. Tenant Quota Management
  6. Querying Tenant Quotas

Querying Tenant Quotas

Function Description

This interface is used to query quotas, including specifications of ECSs, CPUs, and memory.

Extension Description

This API provides the user_id parameter for obtaining the quota configuration of a specified user.

URI

GET /v2/{project_id}/os-quota-sets/{project_id}?user_id={user_id}

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

N/A

Response

Response parameters

Table 2 describes the response parameters.

Table 2 Response parameters

Parameter

Type

Description

quota_set

Dict

Specifies the quota_set object.

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.

This field is not supported in microversions later than 2.36.

floating_ips

Integer

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

This field is not supported in microversions later than 2.36.

id

String

Specifies the project UUID.

injected_file_content_bytes

Integer

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

This field is not supported in microversions later than 2.56.

injected_file_path_bytes

Integer

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

This field is not supported in microversions later than 2.56.

injected_files

Integer

Specifies the quantity quota of the files to be injected.

This field is not supported in microversions later than 2.56.

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 field is not supported in microversions later than 2.36.

security_groups

Integer

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

This field is not supported in microversions later than 2.36.

server_groups

Integer

Specifies the quantity quota of ECS groups.

server_group_members

Integer

Specifies the size quota of ECS groups.

Examples

  • Example request
    GET /v2/d9ebe43510414ef590a4aa158605329e/os-quota-sets/d9ebe43510414ef590a4aa158605329e
    GET /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
    }
    }

Returned Values

See General Request Returned Values.