Calls the CheckDomainRecord operation to check whether a specified DNS record exists on an authoritative DNS server.

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 CheckDomainRecord

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

DomainName String Yes example.com

The domain name.
RR String Yes zhaohui

The host record.
Type String Yes TXT

The type of the DNS record.
Value String Yes fd87da3c4528844d45af39200155a905

The value of the DNS record.
AccessKeyId String No your_accesskey_id

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

The language type.
UserClientIp String No 1.1.1.1

The IP address of the client.

Response parameters

Parameter Type Example Description
IsExist Boolean true

Indicates whether the DNS record exists. Valid values:

  • true: The DNS record exists.
  • false: The DNS record does not exist.
RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

The ID of the request.

Examples

Sample requests


http(s)://alidns.aliyuncs.com/?Action=CheckDomainRecord
&DomainName=example.com
&RR=zhaohui
&Type=TXT
&Value=fd87da3c4528844d45af39200155a905
&<Common request parameters>

Sample success responses

XML format 

<CheckDomainRecordResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <IsExist>true</IsExist>
</CheckDomainRecordResponse>

JSON format 

{
	"RequestId":"536E9CAD-DB30-4647-AC87-AA5CC38C5382",
	"IsExist":false
}

Error codes

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