Updated on 2024-03-14 GMT+08:00

Querying Resource Quotas

Function

This API is used to query the DNS resource quotas of a specific tenant. The resources include:

  • Public zones
  • Private zones
  • Record sets
  • PRT records
  • Resolution lines

URI

GET /v2/quotamg/dns/quotas

Request

  • Parameter description
    Table 1 Parameters in the request

    Parameter

    Mandatory

    Type

    Description

    domain_id

    Yes

    String

    Specifies the tenant ID.

  • Example request

    Querying resource quotas of a tenant

    GET https://{DNS_Endpoint}//v2/quotamg/dns/quotas&domain_id=xxxx

Response

  • Parameter description
    Table 2 Parameters in the response

    Parameter

    Type

    Description

    quotas

    Array of object

    Resource quota list. For details, see Table 3.

    Table 3 Description of the quotas field

    Parameter

    Type

    Description

    quota_key

    String

    Resource type.

    quota_limit

    Interger

    Maximum resource quota.

    used

    Interger

    Used resource quota

    unit

    String

    Quota measurement unit. The value is fixed at count.

  • Example response
    {
      "quotas": [
        {
          "quota_key": "zone",
          "quota_limit": 50,
          "used": 30,
          "unit": "count",
        },
        {
          "quota_key": ""private zone",
          "quota_limit": 50,
          "used": 30,
          "unit": "count",
        }
      ]
    }

Returned Value

If a 2xx status code is returned, for example, 200, 202, or 204, the request is successful.

For details, see Status Code.