云解析怎么获取子域名的解析记录列表
描述
根据传入参数获取子域名的解析记录列表。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
| 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}]}}
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
您所描述的是阿里云DNS（Alibaba Cloud DNS）服务中的一个API操作，用于获取子域名的解析记录列表。这个API可以帮助用户管理和查询其在阿里云上配置的DNS解析设置。下面是对您所提供信息的一个详细解析和补充说明：
请求参数说明
-
Action: 必须参数，固定值
DescribeSubDomainRecords，表示请求的操作是查询子域名解析记录。 -
SubDomain: 必须参数，填写您想查询解析记录的子域名，如
www.example.com。如果直接输入顶级域名如example.com，系统会将其视为@.example.com，即根域名的解析记录。 -
PageNumber: 可选参数，默认为1，用于指定当前查询页码，从1开始计数。
-
PageSize: 可选参数，默认为20，最大500，用来控制每页返回的解析记录数量。
-
Type: 可选参数，如果不填，则返回该子域名下所有类型的解析记录。支持的类型包括但不限于：A、MX、CNAME、TXT、REDIRECT_URL（重定向URL）、FORWARD_URL（转发URL）、NS、AAAA、SRV等。
返回参数说明
- RequestId: 每次API调用都会返回一个唯一的识别码，用于问题追踪。
- TotalCount: 表示查询到的解析记录总数。
- PageNumber: 当前查询的页码。
- PageSize: 本次查询实际返回的解析记录数量。
- DomainRecords下的RecordType: 解析记录列表，包含具体的解析记录详情，如记录类型、记录值、TTL等。
错误码示例
- IncorrectDomainUser: HTTP状态码400错误，意味着请求中有误，具体错误信息指出域名不属于当前用户账户，这通常是因为尝试查询或操作一个不属于当前阿里云账号管理的域名。
示例请求
您提供的请求示例是一个基本的API调用格式，通过HTTP GET方法访问阿里云DNS服务的API地址，并通过查询字符串传递操作参数：
http://alidns.aliyuncs.com/?Action=DescribeSubDomainRecords
请注意，实际使用时，除了Action外，还需根据需要添加其他必要的参数，如SubDomain等，并且为了安全和认证，还需要提供AccessKeyId、Signature等鉴权信息，这些通常通过HTTP头或者POST请求体中以JSON格式发送。具体构造请求和签名的方法可以参考阿里云API文档中的指导。
