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

错误码

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