Querying information about a DNS record - Alibaba Cloud DNS

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	DescribeDomainRecordInfo	The operation that you want to perform. Set the value to DescribeDomainRecordInfo.
RecordId	String	Yes	9999985	The ID of the DNS record. This parameter is returned when you add a DNS record or when you query the list of DNS records.
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	192.0.2.0	The IP address of the client.

Response parameters


Parameter	Type	Example	Description
DomainId	String	00efd71a-770e-4255-b54e-6fe5659baffe	The ID of the domain name.
DomainName	String	example.com	The domain name.
GroupId	String	2223	The ID of the domain name group.
GroupName	String	MyGroup	The name of the domain name group.
Line	String	default	The resolution line.
Locked	Boolean	true	The lock status of the DNS record. Valid values: true and false.
Priority	Long	5	The priority of the MX-type DNS record.
PunyCode	String	xn--fsq270a.com	The punycode is only returned for Chinese domain names.
RR	String	@	The host record.
RecordId	String	9999985	The ID of the DNS record.
RequestId	String	536E9CAD-DB30-4647-AC87-AA5CC38C5382	The ID of the request.
Status	String	Enable	The status of the DNS record. Valid values: Enable and Disable.
TTL	Long	600	The TTL of the resolution.
Type	String	MX	The type of the DNS record.
Value	String	mail.hichina.com	The value of the DNS record.

Examples

Sample requests


http(s)://alidns.aliyuncs.com/?Action=DescribeDomainRecordInfo
&RecordId=9999985
&<Common request parameters>

Sample success responses

XML format

<DescribeDomainRecordInfoResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <DomainName>example.com</DomainName>
      <RecordId>9999985</RecordId>
      <RR>@</RR>
      <Type>MX</Type>
      <Value>mail.hichina.com</Value>
      <Line>default</Line>
      <Priority>5</Priority>
      <TTL>600</TTL>
      <Status>Enable</Status>
      <Locked>false</Locked>
</DescribeDomainRecordInfoResponse>

JSON format

{
	"RR":"@",
	"Status":"Enable",
	"Value":"mail.hichina.com",
	"RecordId":"9999985",
	"Type":"MX",
	"RequestId":"536E9CAD-DB30-4647-AC87-AA5CC38C5382",
	"DomainName":"example.com",
	"Locked":false,
	"Line":"default",
	"TTL":600,
	"Priority":5
}

Error codes

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