调用DescribeSubDomainRecords根据传入参数获取某个固定子域名的所有解析记录列表。

调试

您可以在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
            }
        ]
    }
}

错误码

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