• Cloud Server Backup Service

csbs
  1. Help Center
  2. Cloud Server Backup Service
  3. API Reference
  4. API Description
  5. Quota Management
  6. Querying Quotas

Querying Quotas

Function

This API is used to query tenant quotas.

URI

  • URI format

    GET /v1/{project_id}/quotas

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

Request

  • Element description

None

  • Example request
    GET /v1/{project_id}/quotas

Response

  • Element description

    Parameter

    Type

    Description

    quotas

    quota

    -

  • Parameter description of field quota

    Parameter

    Type

    Description

    resources

    List<resource_resp>

    Quota resources

  • Parameter description of field resource_resp

    Parameter

    Type

    Description

    unit

    String

    Unit

    used

    Integer

    Used quota

    quota

    Integer

    Quota size

    type

    String

    Type

    Enum:[backup_capacity,backups]

    backup_capacity specifies the capacity quota. Value -1 indicates no restriction on the quota size.

    backups specifies the number of retained backups.

  • Example response
    {
      "quotas" : {
        "resources" : [{
          "type" : "backup_capacity",
          "unit" : "GB",
          "quota" : -1,
          "used" : 0
        },
        {
            "used": 0,
            "type": "backups",
            "quota": 600
        }]
      }
    }

Status Codes

  • Normal

    Status Code

    Description

    200

    OK

  • Abnormal

    Status Code

    Description

    400

    Invalid request parameters.

    401

    Authentication failed.

    403

    No operation permission.

    404

    Requested object not found.

    500

    Service internal error.

    503

    Service unavailable.

Error Codes

For details, see Error Codes.