Updated on 2026-01-09 GMT+08:00

Querying the Tenant Quotas

Function

This API is used to query quotas of a tenant.

URI

GET /v2/{project_id}/fgs/quotas

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

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

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

The user token.

The token can be obtained by calling the IAM API. The value of X-Subject-Token in the response header is the user token.

Content-Type

Yes

String

Message body type (format).

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

quotas

ListQuotasResult object

Quota information.

Table 4 ListQuotasResult

Parameter

Type

Description

resources

Array of Resources objects

List of quotas.

Table 5 Resources

Parameter

Type

Description

quota

Integer

Function quota.

used

Integer

Used quota.

type

String

Resource type.

Enumerated values:

  • fgs_func_scale_down_timeout: release time of idle function instances in FunctionGraph v1
  • fgs_func_occurs: quota of function instances in v1 and reserved instances in v2
  • fgs_func_pat_idle_time: release time of idle PAT in VPC function of the v1 version
  • fgs_func_num: function quantity quota
  • fgs_func_code_size: quota of the total code size of user functions
  • fgs_workflow_num: quota of function flows
  • fgs_on_demand_instance_limit: maximum number of instances per function in FunctionGraph v2
  • fgs_func_qos_limit: instance quantity quota of user functions

unit

String

Resource unit. For fgs_func_code_size, the unit is MB. In other scenarios, there is no unit.

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 401

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 403

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 500

Table 9 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Request

This API is used to query the tenant quotas.

GET /v2/{project_id}/fgs/quotas

Example Response

Status code: 200

Successfully queried.

{
  "quotas" : {
    "resources" : [ {
      "quota" : 60,
      "used" : 3,
      "type" : "fgs_func_scale_down_timeout"
    }, {
      "quota" : 100,
      "used" : 22,
      "type" : "fgs_func_occurs"
    }, {
      "quota" : 100,
      "used" : 22,
      "type" : "fgs_func_pat_idle_time"
    }, {
      "quota" : 100,
      "used" : 22,
      "type" : "fgs_func_num"
    }, {
      "quota" : 10240,
      "used" : 22,
      "type" : "fgs_func_code_size",
      "unit" : "MB"
    }, {
      "quota" : 512,
      "used" : 22,
      "type" : "fgs_workflow_num"
    } ]
  }
}

Status Code

Status Code

Description

200

Successfully queried.

400

Bad request.

401

Unauthorized.

403

Forbidden.

500

Internal server error.

Error Code

See Error Codes.