获取子域名的解析记录列表_解析管理接口_API文档

描述

根据传入参数获取子域名的解析记录列表。

请求参数

名称	类型	是否必须	描述
Action	String	是	操作接口名，系统规定参数，取值：DescribeSubDomainRecords
SubDomain	String	是	域名名称，如www.abc.com，如果输入的是abc.com，则认为是@.abc.com；
PageNumber	Long	否	当前页数，起始值为1，默认为1
PageSize	Long	否	分页查询时设置的每页行数，最大值500，默认为20
Type	String	否	如果不填写，则返回子域名对应的全部解析记录类型。解析类型包括(不区分大小写)：A、MX、CNAME、TXT、REDIRECT_URL、FORWORD_URL、NS、AAAA、SRV

返回参数

公共返回参数，详见公共返回参数

名称	类型	描述
RequestId	String	唯一请求识别码
TotalCount	Long	解析记录总数
PageNumber	Long	当前页码
PageSize	Long	本次查询获取的解析数量
DomainRecords	RecordType	解析记录列表

错误码

对于所有接口的通用性错误，请参考错误代码表。

错误代码	描述	HTTP 状态码	语义
IncorrectDomainUser	The domain name does not belong to this user.	400	域名在本账户下不存在

示例

请求示例

http://alidns.aliyuncs.com/?Action=DescribeSubDomainRecords
&SubDomain=www.abc.com
&PageNumber=1
&PageSize=20
&Type=CNAME
&<公共请求参数>

返回示例

XML格式

<DescribeSubDomainRecordsResponse>
    <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>CNAME</Type>
            <Value>mail1.hichina.com</Value>
            <Line>default</Line>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
            <Weight>10</Weight>
        </Record>
        <Record>
            <DomainName>example.com</DomainName>
            <RecordId>9999986</RecordId>
            <RR>www</RR>
            <Type>CNAME</Type>
            <Value>mail2.hichina.com</Value>
            <Line>default</Line>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
            <Weight>10</Weight>
        </Record>
    </DomainRecords>
</DescribeSubDomainRecordsResponse>

JSON示例

{
    "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
    "TotalCount": 2,
    "PageNumber": 1,
    "PageSize": 2,
    "DomainRecords": {
        "Record": [
            {
                "DomainName": "example.com",
                "RecordId": "9999985",
                "RR": "www",
                "Type": "CNAME",
                "Value": "mail1.hichina.com",
                "Line": "default",
                "TTL": 600,
                "Status": "Enable",
                "Locked": false,
                "Weight": 10
            },
            {
                "DomainName": "example.com",
                "RecordId": "9999986",
                "RR": "www",
                "Type": "CNAME",
                "Value": "mail2.hichina.com",
                "Line": "default",
                "TTL": 600,
                "Status": "Enable",
                "Locked": false,
                "Weight": 10
            }
        ]
    }
}