阅读536 返回首页    go 阿里云 go 技术社区[云栖]

获取解析记录列表__解析管理接口_API文档_云解析-阿里云

描述

根据传入参数获取解析记录列表。

查询可以指定域名（DomainName）、页码（PageNumber）和每页的数量（PageSize）来获取域名的解析列表。

查询可以指定解析记录的主机记录关键字（RRKeyWord）、解析类型关键字（TypeKeyWord）或者记录值的关键字（ValueKeyWord）来查询含有该关键字的解析列表。

解析列表的默认排序方式是按照解析添加的时间从新到旧排序的。

请求参数

名称 类型 是否必须 描述
Action String 是 操作接口名，系统规定参数，取值：DescribeDomainRecords
DomainName String 是 域名名称
PageNumber Long 否 当前页数，起始值为1，默认为1
PageSize Long 否 分页查询时设置的每页行数，最大值500，默认为20
RRKeyWord String 否 主机记录的关键字，按照”%RRKeyWord%”模式搜索，不区分大小写
TypeKeyWord String 否 解析类型的关键字，按照全匹配搜索，不区分大小写
ValueKeyWord String 否 记录值的关键字，按照”%ValueKeyWord%”模式搜索，不区分大小写

返回参数

公共返回参数，详见公共返回参数

名称 类型 描述
RequestId String 唯一请求识别码
TotalCount Long 解析记录总数
PageNumber Long 当前页码
PageSize Long 本次查询获取的解析数量
DomainRecords RecordType 解析记录列表

错误码

对于所有接口的通用性错误，请参考错误代码表。

错误代码 描述 HTTP 状态码 语义
IncorrectDomainUser The domain name does not belong to this user. 400 域名在本账户下不存在

示例

请求示例

https://alidns.aliyuncs.com/?Action=DescribeDomainRecords
&DomainName=example.com
&PageNumber=1
&PageSize=20
&RRKeyWord=www
&TypeKeyWord=MX
&ValueKeyWord=com
&<公共请求参数>

返回示例

XML格式

<DescribeDomainRecordsResponse>
    <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>MX</Type>
            <Value>mail1.hichina.com</Value>
            <Line>default</Line>
            <Priority>5</Priority>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
        </Record>
        <Record>
            <DomainName>example.com</DomainName>
            <RecordId>9999986</RecordId>
            <RR>www</RR>
            <Type>MX</Type>
            <Value>mail2.hichina.com</Value>
            <Line>default</Line>
            <Priority>10</Priority>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
        </Record>
    </DomainRecords>
</DescribeDomainRecordsResponse>

JSON示例

{
    "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
    "TotalCount": 2,
    "PageNumber": 1,
    "PageSize": 2,
    "DomainRecords": {
        "Record": [
            {
                "DomainName": "example.com",
                "RecordId": "9999985",
                "RR": "www",
                "Type": "MX",
                "Value": "mail1.hichina.com",
                "Line": "default",
                "Priority": 5,
                "TTL": 600,
                "Status": "Enable",
                "Locked": false
            },
            {
                "DomainName": "example.com",
                "RecordId": "9999986",
                "RR": "www",
                "Type": "MX",
                "Value": "mail2.hichina.com",
                "Line": "default",
                "Priority": 10,
                "TTL": 600,
                "Status": "Enable",
                "Locked": false
            }
        ]
    }
}

最后更新：2016-11-23 17:16:06

  上一篇：go 设置解析记录状态__解析管理接口_API文档_云解析-阿里云
  下一篇：go 获取解析记录信息__解析管理接口_API文档_云解析-阿里云