Updated on 2026-08-18 GMT+08:00

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 a response is returned, the value of X-Subject-Token in the response header is the token. Constraints N/A Range N/A Default Value N/A
X-Language	No	String	Definition Language of the information returned by the API. Constraints N/A Range zh-cn: Chinese en-us: English Default Value en-us

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
eps_tags	Yes	Array of strings	Definition Enterprise project IDs. You can obtain the enterprise project IDs by calling the API for listing enterprise projects in Enterprise Management API Reference. The values of id in the response are 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 -1 and (0,2147483647]. -1 indicates no limit.
cpu_eps_quota	Integer	Definition CPU quota, in cores. Range -1 and (0,2147483647]. -1 indicates no limit.
mem_eps_quota	Integer	Definition Memory quota, in GB. Range -1 and (0,2147483647]. -1 indicates no limit.
volume_eps_quota	Integer	Definition Storage quota, in GB. Range -1 and (0,2147483647]. -1 indicates no limit.
instance_eps_remaining_quota	Integer	Definition Remaining instance quota. Range N/A
cpu_eps_remaining_quota	Integer	Definition Remaining CPU quota, in cores. Range N/A
mem_eps_remaining_quota	Integer	Definition Remaining memory quota, in GB. Range N/A
volume_eps_remaining_quota	Integer	Definition Remaining storage quota, in GB. 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 
}

Status Codes

Normal
200
Abnormal
For details, see Status Codes.

Error Codes

For details, see Error Codes.

Parent topic: Quota Management