调用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
}
]
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交