Querying Resource Quotas

Function

This API is used to query DNS resource quotas of a tenant. The resources include public zones, private zones, record sets, PTR records, custom lines, line groups, inbound endpoints, outbound endpoints, and endpoint rules.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
dns:quota:list	List	-	-	dns:zone:get	-

URI

GET /v2/quotamg/dns/quotas

**Table 1** Query Parameters
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Tenant ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition The user token. The token can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token. For details about how to obtain a user token, seeObtaining a User Token. Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
quotas	Array of quotas objects	Quotas.

**Table 4** quotas
Parameter	Type	Description
quota_key	String	Resource type.
quota_limit	Integer	Maximum resource quota.
used	Integer	Used resource quota.
unit	String	Quota measurement unit. The value is fixed at count.

Example Requests

None

Example Responses

Status code: 200

Response to the request for querying tenant quotas

{
  "quotas" : [ {
    "quota_key" : "zone",
    "quota_limit" : 50,
    "used" : 30,
    "unit" : "count"
  }, {
    "quota_key" : "record_set",
    "quota_limit" : 500,
    "used" : 300,
    "unit" : "count"
  } ]
}