Calls the DeleteSubDomainRecords operation to delete DNS records corresponding to a host record based on input parameters.

If the DNS records to be deleted contain locked DNS records, locked DNS records will not be deleted.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteSubDomainRecords

The operation that you want to perform. Set the value to DeleteSubDomainRecords.

DomainName String Yes example.com

The domain name.
RR String Yes www

The host record.

For example, to resolve @.example.com, you must set RR to an at sign (@) instead of leaving it blank.

AccessKeyId String No your_accesskey_id

The AccessKey ID provided to you by Alibaba Cloud.
Lang String No en

The language type.
Type String No A

The type of the DNS record. If you do not specify this parameter, all DNS record types corresponding to the subdomain name are returned.

DNS record types include A, MX, CNAME, TXT, REDIRECT_URL, FORWORD_URL, NS, AAAA, and SRV. The value is not case-sensitive.

UserClientIp String No 192.0.2.0

The IP address of the client.

Response parameters

Parameter Type Example Description
RR String www

The host record.
RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

The ID of the request.
TotalCount String 1

The total number of deleted DNS records.

Examples

Sample requests


http(s)://alidns.aliyuncs.com/?Action=DeleteSubDomainRecords
&DomainName=example.com
&RR=www
&<Common request parameters>

Sample success responses

XML format 

<DeleteSubDomainRecordsResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <RR>www</RR>
      <TotalCount>1</TotalCount>
</DeleteSubDomainRecordsResponse>

JSON format 

{
	"RR":"www",
	"TotalCount":"1",
	"RequestId":"536E9CAD-DB30-4647-AC87-AA5CC38C5382"
}

Error codes

For a list of error codes, visit the API Error Center.