Updated on 2025-05-28 GMT+08:00

Querying Image Quotas

Function

This extension API is used to query private image quotas of a tenant in the current region.

URI

GET /v1/{project_id}/cloudimages/quota

The following table describes the parameters.

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

Request

Request parameters

None

Example Request

Querying image quotas

GET https://{Endpoint}/v1/fd73a4a14a4a4dfb9771a8475e5198ea/cloudimages/quota

Response

  • Response parameters

    Parameter

    Type

    Description

    quotas

    Object

    Specifies the quota details.

    For details, see Table 1.

    Table 1 Data structure description of the quotas field

    Parameter

    Type

    Description

    resources

    Array of objects

    Specifies the resources whose quota needs to be queried.

    For details, see Table 2.

    Table 2 Data structure description of the quotas.resources field

    Parameter

    Type

    Description

    type

    String

    Specifies the resource type.

    used

    Integer

    Specifies the used quota.

    quota

    Integer

    Specifies the total quota.

    min

    Integer

    Specifies the minimum quota.

    max

    Integer

    Specifies the maximum quota.

  • Response example
    STATUS CODE 200
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    {
      "quotas": {
        "resources": [
          {
            "type": "image",
            "used": 0,
            "quota": 20,
            "min": 1,
            "max": 1000
          }
        ]
      }
    }
    

Returned Values

  • Normal

    200

  • Abnormal

    Returned Value

    Description

    400 Bad Request

    Request error. For details, see Error Codes.

    401 Unauthorized

    Authentication failed.

    403 Forbidden

    No operation permissions.

    404 Not Found

    Resource not found.

    500 Internal Server Error

    Internal service error.

    503 Service Unavailable

    Service unavailable.