调用DescribeDomainRecords根据传入参数获取指定主域名的所有解析记录列表。

  • 查询可以指定域名（DomainName）、页码（PageNumber）和每页的数量（PageSize）来获取域名的解析列表。
  • 查询可以指定解析记录的主机记录关键字（RRKeyWord）、解析类型关键字（TypeKeyWord）或者记录值的关键字（ValueKeyWord）来查询含有该关键字的解析列表。
  • 解析列表的默认排序方式是按照解析添加的时间从新到旧排序的。
  • 可以指定域名分组的ID（GroupId），全部域名代表所有域名、默认分组代表未设置分组的域名。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeDomainRecords

系统规定参数。取值：DescribeDomainRecords。
Lang String 否 en

语言
DomainName String 是 example.com

域名名称。
PageNumber Long 否 1

当前页数，起始值为1，默认为1。
PageSize Long 否 20

分页查询时设置的每页行数，最大值500，默认为20。
KeyWord String 否 test

关键字。
RRKeyWord String 否 www

主机记录的关键字，按照 RRKeyWord（前后模糊匹配）模式搜索，不区分大小写。
TypeKeyWord String 否 MX

解析类型的关键字，按照全匹配搜索，不区分大小写。
ValueKeyWord String 否 com

记录值的关键字，按照 ValueKeyWord（前后模糊匹配）模式搜索，不区分大小写。
OrderBy String 否 default

排序方式。按照解析添加的时间从新到旧排序。
Direction String 否 DESC

排序方向。取值范围：DESC、ASC。默认为：DESC。
SearchMode String 否 LIKE

搜索模式，取值：LIKE/EXACT/ADVANCED。

  • 填入LIKE或EXACT时，请使用KeyWord参数。（传入RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、Status参数无效）
  • 填入ADVANCED时，请使用RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、Status
  • 不传值：
    • keyWord传值，搜索模式取”LIKE“值。
    • keyWord不传值，RRKeyWord和ValueKeyWord支持模糊查询，TypeKeyWord和Type、Line、Status支持精确查询。
GroupId Long 否 2223

指域名分组ID

  • 如不传GroupId，则在全部域名下查询。
  • 如GroupId为0，则返回空数据。
  • 如GroupId为-1，则在默认分组（指未设置分组的域名）下查询。
  • 如GroupId为-2，则在全部域名下查询。
  • 如GroupId不符合上述条件，则按GroupId查询并返回结果。
Type String 否 A

解析记录类型，参见：

解析记录类型格式
Line String 否 cn_mobile_anhui

解析线路，默认为default。

参见：

。

解析线路枚举
Status String 否 Enable

解析记录状态，取值：Enable/Disable。

返回数据

名称 类型 示例值 描述
TotalCount Long 2

解析记录总数。
PageSize Long 20

本次查询获取的解析数量。
RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

请求ID。
DomainRecords Array of Record

解析记录列表。
Record
Status String Enable

当前的解析记录状态。
Type String MX

记录类型。
Remark String 备注

备注。
TTL Long 600

缓存时间设置。单位：秒。
RecordId String 9999985

解析记录ID。
Priority Long 5

mx记录的优先级。
RR String www

主机记录。
DomainName String example.com

域名名称。
Weight Integer 2

负载均衡权重。
Value String mail1.hichina.com

记录值。
Line String default

解析线路。
Locked Boolean false

当前解析记录锁定状态。
PageNumber Long 1

当前页码。

示例

请求示例

正常返回示例

JSON格式

HTTP/1.1 200 OK

错误码

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