入门示例

第一步,获取域名列表

获取域名列表(DescribeDomains),可选参数为页数(PageNumber)、每页域名数量(PageSize)和关键字(KeyWord)。

请求示例

http://alidns.aliyuncs.com/?Action=DescribeDomains
&PageNumber=1
&PageSize=20
&KeyWord=com
&<公共请求参数>

返回示例

<DescribeDomainsResponse>
    <RequestId>6393C3A8-B611-42F2-AFA6-F080FC45D5D0</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <Domains>
        <Domain>
            <DomainId>00efd71a-770e-4255-b54e-6fe5659baffe</DomainId>
            <DomainName>abc.com</DomainName>
            <PunyCode>abc.com</PunyCode>
            <DnsServers>
                <DnsServer>dns1.hichina.com</DnsServer>
                <DnsServer>dns2.hichina.com</DnsServer>
            </DnsServers>
        </Domain>
        <Domain>
            <DomainId>00efd71a-770e-4255-b54e-6fe5659baffe</DomainId>
            <DomainName>实例.com</DomainName>
            <PunyCode>xn--fsq270a.com</PunyCode>
            <DnsServers>
                <DnsServer>dns1.hichina.com</DnsServer>
                <DnsServer>dns2.hichina.com</DnsServer>
            </DnsServers>
        </Domain>
    </Domains>
</DescribeDomainsResponse>

第二步,添加域名

添加域名(AddDomain),指定需要域名名称(DomainName)。

请求示例

http://alidns.aliyuncs.com/?Action=AddDomain
&DomainName=example.com
&<公共请求参数>

返回示例

<AddDomainResponse>
    <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
    <DomainId>00efd71a-770e-4255-b54e-6fe5659baffe</DomainId>
    <DomainName>example.com</DomainName>
    <PunyCode>example.com</PunyCode>
    <DnsServers>
        <DnsServer>dns1.hichina.com</DnsServer>
        <DnsServer>dns2.hichina.com</DnsServer>
    </DnsServers>
</AddDomainResponse>

第三步,获取解析记录列表

获取解析记录列表(DescribeDomainRecords),指定需要域名名称(DomainName),可选参数为页数(PageNumber)、每页域名数量(PageSize)、主机记录关键字(RRKeyWord)、解析类型关键字(TypeKeyWord)和记录值关键字(ValueKeyWord)。

请求示例

http://alidns.aliyuncs.com/?Action=DescribeDomainRecords
&DomainName=example.com
&PageNumber=1
&PageSize=20
&RRKeyWord=www
&TypeKeyWord=MX
&ValueKeyWord=com
&<公共请求参数>

返回示例

<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>
        </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>
        </Record>
    </DomainRecords>
</DescribeDomainRecordsResponse>

第四步,添加解析记录

添加解析记录(AddDomainRecord),指定需要的参数域名名称(DomainName)、主机记录(RR)、记录类型(Type)和记录值(Value),可选参数为解析线路(Line)、MX优先级(Priority)和TTL。

请求示例

http://alidns.aliyuncs.com/?Action=AddDomainRecord
&DomainName=example.com
&RR=www
&Type=A
&Value=202.106.0.20
&TTL=600
&Line=default
&<公共请求参数>

返回示例

<AddDomainRecordResponse>
    <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
    <RecordId>9999985</RecordId>
</AddDomainRecordResponse>