API Overview

The DNS service provides RESTful APIs.

By calling these APIs, you can use all DNS functions, including creating, querying, modifying, and deleting public zones, private zones, and record sets.

Table 1 provides an overview of the DNS APIs.

**Table 1** API overview
Category	Description
Version Management	Query version information of all DNS APIs or a specified API.
Public Zone Management	Create, delete, modify, and query public zones.
Private Zone Management	Create, delete, modify, and query private zones.
Record Set Management	Create, delete, modify, and query record sets in public and private zones.
Multi-line Record Set Management	Create, delete, modify, and query record sets of different resolution lines in public zones.
PTR Record Management	Create, delete, modify, and query PTR records that map EIPs to domain names.
Batch Operations	Delete zones and record sets, and set zone status and record set status in batches.
Tag Management	Create, delete, modify, and query tags for specified DNS resources.
Line Group Management	Create, delete, modify, and query line groups. Create, delete, modify, and query line groups.
Custom Line Management	Create, delete, update, and delete custom lines.
Name Server Management	Query name servers.
Quota Management	Query DNS resource quotas.

Version Management

Query DNS API versions.

**Table 2** Version management APIs
API	Description
Querying All the DNS API Versions	Query the versions of all DNS APIs.
Querying the Specific API Version for DNS	Queries the version of a specified DNS API.

Public Zone Management

Create, query, delete, and modify public zones.

**Table 3** Public zone management APIs
API	Description
Creating a Public Zone	Create a public zone.
Querying a Public Zone	Query a public zone.
Querying Public Zones	Query public zones in list.
Querying Name Servers in a Public Zone	Query name servers in a public zone.
Deleting a Public Zone	Delete a public zone.
Modifying a Public Zone	Modify a public zone.
Setting the Status of a Public Zone	Set the status of a public zone.

Private Zone Management

Create, query, delete, and modify private zones.

**Table 4** Private zone management APIs
API	Description
Creating a Private Zone	Create a private zone.
Associating a VPC with a Private Zone	Associate a private zone with a VPC.
Disassociating a VPC from a Private Zone	Disassociate a VPC from a private zone.
Querying a Private Zone	Query a private zone.
Querying Private Zones	Query private zones.
Querying the Name Server in a Private Zone	Query name servers in a private zone.
Deleting a Private Zone	Delete a private zone.
Modifying a Private Zone	Modify a private zone.

Record Set Management

Create, query, delete, and modify record sets.

**Table 5** Record set management APIs
API	Description
Creating a Record Set	Create a record set.
Querying a Record Set	Query a record set.
Querying Record Sets	Query record sets.
Querying Record Sets in a Zone	Query record sets in a specified zone.
Deleting a Record Set	Delete a record set.
Modifying a Record Set	Modify a record set.

Multi-line Record Set Management

Create, query, delete, and modify record sets with multiple resolution lines.

**Table 6** Multi-line record set management APIs
API	Description
Creating a Record Set	Create a record set.
Batch Deleting Record Sets in a Zone	Batch delete record sets in a zone.
Batch Modifying Record Sets	Batch modify record sets.
Querying a Record Set	Query a record set. This API applies only to public DNS servers.
Querying Record Sets	Query record sets in list.
Batch Creating Record Sets for Lines	Batch create record sets. This API applies only to public DNS servers.
Querying Record Sets in a Zone	Query all record sets in a specified zone.
Deleting a Record Set	Delete a record set.
Modifying a Record Set	Modify a record set.
Setting Record Set Status	Set the status of a record set.

PTR Record Management

Set, query, modify, and unset PTR records for EIPs.

**Table 7** PTR record management APIs
API	Description
Creating a PTR Record for an EIP	Configure a PTR record for an EIP.
Querying PTR Records of an EIP	Query the PTR record of an EIP.
Querying PTR Records	Query PTR records of EIPs.
Restoring the PTR Record of the EIP to the Default Value	Restore the PTR record of an EIP to the default value.
Modifying the PTR Record of an EIP	Modify the PTR record for an EIP.

Batch Operations

These APIs are used to manage zones, PTR record, and record sets in batches, including batch deleting zones, PTR records, and record sets, and batch setting zone status and record set status.

**Table 8** APIs for batch operations
API	Description
Batch Deleting Zones	Batch delete zones.
Batch Deleting Record Sets	Delete record sets in batches.
Batch Setting Zone Status	Batch set zone status.
Batch Setting the Status of Record Sets	Batch set the status of record sets.

Tag Management

Add, delete, and query resource tags.

**Table 9** Tag management APIs
API	Description
Adding a Tag to a Specific Resource	Add tags to a specified resource. You can add up to 10 tags to a resource.
Deleting a Resource Tag	Delete a resource tag.
Batch Adding or Deleting Tags for a Specific Instance	Add or delete tags for a specified resource in batches.
Querying Tags of a Specific Instance	Query tags of a specified resource.
Querying All Tags of a Specific Resource	Query all tags of a resource type.
Querying Resources Using Tags	Query DNS resources by tag. Resources are sorted by creation time in descending order.

Line Group Management

**Table 10** Line group management APIs
API	Description
Creating a Line Group	Create a line group.
Querying Line Groups	Query line groups.
Querying a Line Group	Query a line group.
Updating a Line Group	Update a line group.
Deleting a Line Group	Delete a line group.

Custom Line Management

Create, delete, update, and query custom lines.

**Table 11** Custom line management APIs
API	Description
Creating a Custom Line	Create a custom line.
Querying a Custom Line	Query custom lines.
Deleting a Custom Line	Delete a custom line.
Updating a Custom Line	Update a custom line.