edit-icon download-icon

Retrieving Resolution Record Lists

Last Updated: May 27, 2016

Description

Resolution record lists are retrieved based on input parameters.

When querying, the user can specify the domain name (DomainName), page number (PageNumber), and number of records per page (PageSize) to retrieve a domain name resolution record list.

When querying, the user can specify a host record keyword (RRKeyWord), resolution type keyword (TypeKeyWord), or record value keyword (ValueKeyWord) to query a list of resolution records that contain the specified keyword.

By default, the resolution list is sorted by time added, from most to least recent.

Request Parameters

Name Type Required? Description
Action String Yes Operator interface name, required parameter, value:DescribeDomainRecords
DomainName String Yes Domain name
PageNumber Long No Number of the current page, starting from 1 by default
PageSize Long No When querying by page, this parameter sets the number of lines per page. Maximum value: 500, default value: 20
RRKeyWord String No The host record keyword for "%RRKeyWord%" mode searches, case insensitive
TypeKeyWord String No The resolution type keyword for full match searches, case insensitive
ValueKeyWord String No The record value keyword for "%ValueKeyWord%" mode searches, case insensitive

Return Parameters

Public return parameters. For details, see Public Return Parameters

Name Type Description
RequestId String The unique request identifier
TotalCount Long Total number of resolution records
PageNumber Long Number of the current page
PageSize Long Number of resolution records retrieved by this query
DomainRecords RecordType The resolution record list

Error Codes

For errors common to all interfaces, please refer to the Error Code Table.

Error Code Description HTTP Status Code Meaning
IncorrectDomainUser The domain name does not belong to this user. 400 The domain name does not exist under this account

Example

Request Example

http://dns.aliyuncs.com/?Action=DescribeDomainRecords
&DomainName=example.com
&PageNumber=1
&PageSize=20
&RRKeyWord=www
&TypeKeyWord=MX
&ValueKeyWord=com
&<Public Request Parameters>

Return Example

XML Format

<DescribeDomainRecordsResponse>
    <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <DomainRecords>
        <Record>
            <DomainName>example.com</DomainName>
            <RecordId>9999985</RecordId>
            <RR>www</RR>
            <Type>MX</Type>
            <Value>mail1.hichina.com</Value>
            <Line>default</Line>
            <Priority>5</Priority>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
        </Record>
        <Record>
            <DomainName>example.com</DomainName>
            <RecordId>9999986</RecordId>
            <RR>www</RR>
            <Type>MX</Type>
            <Value>mail2.hichina.com</Value>
            <Line>default</Line>
            <Priority>10</Priority>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
        </Record>
    </DomainRecords>
</DescribeDomainRecordsResponse>

JSON Example

{
    "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
    "TotalCount": 2,
    "PageNumber": 1,
    "PageSize": 2,
    "DomainRecords": {
        "Record": [
            {
                "DomainName": "example.com",
                "RecordId": "9999985",
                "RR": "www",
                "Type": "MX",
                "Value": "mail1.hichina.com",
                "Line": "default",
                "Priority": 5,
                "TTL": 600,
                "Status": "Enable",
                "Locked": false
            },
            {
                "DomainName": "example.com",
                "RecordId": "9999986",
                "RR": "www",
                "Type": "MX",
                "Value": "mail2.hichina.com",
                "Line": "default",
                "Priority": 10,
                "TTL": 600,
                "Status": "Enable",
                "Locked": false
            }
        ]
    }
}
Thank you! We've received your feedback.