Help Center/ GaussDB/ API Reference/ APIs (Recommended)/ Quota Management/ Querying the Remaining Quota of Enterprise Projects

Updated on 2025-10-20 GMT+08:00

View PDF

Querying the Remaining Quota of Enterprise Projects

Function

This API is used to query the remaining quota of enterprise projects. Before calling this API:

Learn how to authenticate this API.
Obtain the required region and endpoint.

Debugging

You can debug this API in API Explorer.

URI

POST /v3/{project_id}/enterprise-projects/remaining-quotas

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID. Constraints N/A Range The value can contain 32 characters. Only letters and digits are allowed. Default Value N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. You can obtain the token by calling the IAM API used to obtain a user token. After the request is processed, the value of X-Subject-Token in the message header is the token value. Constraints N/A Range N/A Default Value N/A
X-Language	No	String	Definition Language. Constraints N/A Range zh-cn en-us Default Value en-us

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
eps_tags	Yes	Array of strings	Definition Enterprise project IDs. Constraints N/A

Response

**Table 4** Response body parameters
Parameter	Type	Description
eps_remaining_quotas	Array of EpsRemainingQuota objects	Definition Remaining enterprise project quota. For details, see Table 5.
job_id	String	Definition Job ID. Range N/A
total_count	Integer	Definition Number of returned enterprise projects. Range N/A

**Table 5** EpsRemainingQuota field data structure description
Parameter	Type	Description
eps_tag	String	Definition Enterprise project ID. Range N/A
instance_eps_quota	Integer	Definition Instance quota. Range N/A
cpu_eps_quota	Integer	Definition CPU quota. Range N/A
mem_eps_quota	Integer	Definition Memory quota. Range N/A
volume_eps_quota	Integer	Definition Storage space quota. Range N/A
instance_eps_remaining_quota	Integer	Definition Remaining instance quota. Range N/A
cpu_eps_remaining_quota	Integer	Definition Remaining CPU quota. Range N/A
mem_eps_remaining_quota	Integer	Definition Remaining memory quota. Range N/A
volume_eps_remaining_quota	Integer	Definition Remaining storage quota. Range N/A

Example Request

Querying the remaining quota of enterprise projects

POST https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/enterprise-projects/remaining-quotas
{ 
  "eps_tags" : [ "0" ] 
}

Example Response

{ 
  "eps_remaining_quotas" : [ { 
    "eps_tag" : "0", 
    "instance_eps_quota" : -1, 
    "cpu_eps_quota" : -1, 
    "mem_eps_quota" : -1, 
    "volume_eps_quota" : -1, 
    "instance_eps_remaining_quota" : 2147483647, 
    "cpu_eps_remaining_quota" : 2147483647, 
    "mem_eps_remaining_quota" : 2147483647, 
    "volume_eps_remaining_quota" : 2147483647 
  } ], 
  "job_id" : "7328736d-267e-4969-8202-1be71579406e", 
  "total_count" : 1 
}