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

Querying Resource Quotas

Function

This API is used to query resource quotas in a project.

URI

  • URI format

    GET /v3/{project_id}/quotas

  • Parameter description
    Table 1 Parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Definition

    Project ID of a tenant in a region.

    To obtain the value, see Obtaining a Project ID.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

Request

  • Request parameters

    None

  • URI example

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/quotas

Response

  • Normal response
    Table 2 Parameters

    Parameter

    Type

    Description

    quotas

    Object

    Definition

    Specifies the objects in the quota list.

    For details, see Table 3.

    Table 3 quotas field data structure description

    Parameter

    Type

    Description

    resources

    Array of objects

    Definition

    Indicates the resource list objects.

    For details, see Table 4.

    Table 4 resources field data structure description

    Parameter

    Type

    Description

    quota

    Integer

    Definition

    Indicates the project resource quota.

    Range

    N/A

    used

    Integer

    Definition

    Indicates the number of used resources.

    Range

    N/A

    type

    String

    Definition

    Indicates the project resource type.

    Range

    instance: instance resources

  • Example normal response
    {
      "quotas" : {
        "resources" : [ {
          "quota" : 100,
          "used" : 1,
          "type" : "instance"
        } ]
      }
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.