Help Center/ GaussDB/ API Reference/ APIs (Recommended)/ Quota Management/ Querying Enterprise Project Quotas
Updated on 2024-08-20 GMT+08:00

Querying Enterprise Project Quotas

Function

This API is used to query enterprise project quotas. Before calling this API:

URI

GET https://{Endpoint}/v3/{project_id}/enterprise-projects/quotas

Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Explanation:

Project ID of a tenant in a region.

For details about how to obtain the project ID, see Obtaining a Project ID.

Restrictions:

None

Value range:

The value can contain 32 characters. Only letters and digits are allowed.

Default value:

None

enterprise_project_id

No

String

Enterprise project ID.

- Do not transfer this parameter if enterprise multi-project service is not enabled.

- If enterprise multi-project service is enabled but this parameter is not transferred, the default enterprise project is used.

offset

No

Integer

Index offset. If offset is set to N, the resource query starts from the N+1 data entry. The default value is 0, indicating that the query starts from the first data entry. The value cannot be a negative number. For example, if this parameter is set to 0 and limit is set to 10, only the 1st to 10th records are displayed.

limit

No

Integer

Number of records to be queried. The default value is 100. The value cannot be a negative number. The minimum value is 1 and the maximum value is 100. For example, if this parameter is set to 10, a maximum of 10 records can be displayed.

Request Parameters

None

Response Parameters

Table 2 Parameter description

Parameter

Type

Description

eps_quotas

Array of objects

Enterprise project details.

For details, see Table 3.

total_count

Integer

Total number of records.

Table 3 eps_quotas field data structure description

Parameter

Type

Description

enterprise_project_id

String

Enterprise project ID.

enterprise_project_name

String

Enterprise project name.

instance_eps_quota

Integer

EPS instance quota. The value -1 indicates that the quota is not limited.

vcpus_eps_quota

Integer

EPS compute quota. The value -1 indicates that the quota is not limited.

ram_eps_quota

Integer

EPS memory quota in GB. The value -1 indicates that the quota is not limited.

volume_eps_quota

Integer

EPS storage quota in GB. The value -1 indicates that the quota is not limited.

instance_used

Integer

Used EPS instance quota.

vcpus_used

Integer

Used EPS compute quota.

ram_used

Integer

Used EPS memory quota in GB.

volume_used

Integer

Used EPS storage quota, in GB.

Example Request

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0611f1bd8b00d5d32f17c017f15b599f/enterprise-projects/quotas

Example Response

{ 
   "eps_quotas" : [ { 
     "enterprise_project_id" : "2c049d98-3347-494f-8767-99af6b3aa5f0", 
     "enterprise_project_name" : "default", 
     "instance_eps_quota" : 100, 
     "vcpus_eps_quota" : 1500, 
     "ram_eps_quota" : 20000, 
     "volume_eps_quota" : 100000, 
     "instance_used" : 33, 
     "vcpus_used" : 1460, 
     "ram_used" : 19680, 
     "volume_used" : 8840 
   }, { 
     "enterprise_project_id" : "2c049d98-3347-494f-8767-99af6b3aa5f0", 
     "enterprise_project_name" : "11111", 
     "instance_eps_quota" : -1, 
     "vcpus_eps_quota" : -1, 
     "ram_eps_quota" : -1, 
     "volume_eps_quota" : -1, 
     "instance_used" : 2, 
     "vcpus_used" : 54, 
     "ram_used" : 384, 
     "volume_used" : 680 
   }, { 
     "enterprise_project_id" : "bd91e1eb-2e33-4f17-a8d4-05eb2c805781", 
     "enterprise_project_name" : "quota_at_gaussdbv5_test", 
     "instance_eps_quota" : -1, 
     "vcpus_eps_quota" : -1, 
     "ram_eps_quota" : -1, 
     "volume_eps_quota" : -1, 
     "instance_used" : 1, 
     "vcpus_used" : 240, 
     "ram_used" : 1920, 
     "volume_used" : 480 
   } ], 
   "total_count" : 3 
 }

Status Code

Error Code

For details, see Error Codes.