获取子域名解析记录列表 - 云解析 DNS

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeSubDomainRecords	系统规定参数。取值：DescribeSubDomainRecords。
SubDomain	String	是	a.www.example.com	以参数SubDomain为a.www.example.com为示例：如果参数DomainName为空，则查询域名为example.com、主机名为”a.www“的解析记录。如果参数DomainName为 www.example.com，则查询域名为www.example.com、主机名为 "a"的解析记录。如果参数DomainName为 a.www.example.com，则查询域名为a.www.example.com、主机名为 "@"的解析记录。
Lang	String	否	en	语言。
UserClientIp	String	否	1.1.1.1	用户端IP。
PageNumber	Long	否	1	当前页数，起始值为1，默认为1。
PageSize	Long	否	20	分页查询时设置的每页行数，最大值500，默认为20。
Type	String	否	MX	解析记录类型。若不传值，则返回子域名对应的全部解析记录类型。解析类型包括(不区分大小写)：A、MX、CNAME、TXT、REDIRECT_URL、FORWORD_URL、NS、AAAA、SRV。
Line	String	否	default	解析线路。
DomainName	String	否	example.com	域名名称。

返回数据


名称	类型	示例值	描述
RequestId	String	536E9CAD-DB30-4647-AC87-AA5CC38C5382	请求ID。
TotalCount	Long	2	解析记录总数。
PageNumber	Long	1	当前页码。
PageSize	Long	2	本次查询获取的解析数量。
DomainRecords	Array		解析记录列表。
DomainName	String	example.com	域名名称
RecordId	String	9999985	解析记录ID
RR	String	www	主机记录
Type	String	CNAME	记录类型
Value	String	mail1.hichina.com	记录值
TTL	Long	600	生存时间
Priority	Long	2	MX记录的优先级
Line	String	default	解析线路
Status	String	Enable	解析记录状态
Locked	Boolean	false	解析记录锁定状态
Weight	Integer	10	解析记录的权重

示例

请求示例

http(s)://alidns.aliyuncs.com/?Action=DescribeSubDomainRecords
&SubDomain=www.abc.com
&<公共请求参数>

正常返回示例

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
            }
        ]
    }
}

错误码

访问错误中心查看更多错误码。