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

  • 查询可以指定域名(DomainName)、页码(PageNumber)和每页的数量(PageSize)来获取域名的解析列表。
  • 查询可以指定解析记录的主机记录关键字(RRKeyWord)、解析类型关键字(TypeKeyWord)或者记录值的关键字(ValueKeyWord)来查询含有该关键字的解析列表。
  • 解析列表的默认排序方式是按照解析添加的时间从新到旧排序的。

调试

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

请求参数

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

系统规定参数。取值:DescribeDomainRecords

DomainName String example.com

域名名称。

GroupId Long 2223

域名分组ID。

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支持精确查询。
KeyWord String test

关键字。

RRKeyWord String www

主机记录的关键字,按照 RRKeyWord(前后模糊匹配)模式搜索,不区分大小写。

TypeKeyWord String MX

解析类型的关键字,按照全匹配搜索,不区分大小写。

ValueKeyWord String com

记录值的关键字,按照 ValueKeyWord(前后模糊匹配)模式搜索,不区分大小写。

Type String A

解析记录类型,参见:

解析记录类型格式

Line String default

解析线路,默认为default

参见:

解析线路枚举

OrderBy String default

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

Direction String DESC

排序方向。取值范围:DESC、ASC。默认为:DESC。

Status String Enable

解析记录状态,取值:Enable/Disable

PageNumber Long 1

当前页数,起始值为1,默认为1

PageSize Long 20

分页查询时设置的每页行数,最大值500,默认为20

Lang String en

语言。

返回数据

名称 类型 示例值 描述
DomainRecords Array of Record

解析记录列表。

Record
DomainName String example.com

域名名称。

Line String default

解析线路。

Locked Boolean false

当前解析记录锁定状态。

Priority Long 5

MX记录的优先级。

RR String www

主机记录。

RecordId String 9999985

解析记录ID。

Remark String 备注

备注。

Status String Enable

当前的解析记录状态。

TTL Long 600

生存时间。

Type String MX

记录类型。

Value String mail1.hichina.com

记录值。

Weight Integer 2

负载均衡权重。

PageNumber Long 1

当前页码。

PageSize Long 2

本次查询获取的解析数量。

RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

请求ID。

TotalCount Long 2

解析记录总数。

示例

请求示例

http(s)://alidns.aliyuncs.com/?Action=DescribeDomainRecords
&DomainName=example.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
            }
        ]
    }
}

错误码

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