DNS 资源记录列表

用于分页获取域名的 DNS 资源记录

URL 参数

•︎ domain string

完全限定域名 FQDN

•︎ offset number | default = 0

offset 表示分页响应中获取数据的起始位置，即返回实际数据之前需要从开头跳过的项目数

•︎ limit number | default = 50

该参数指定每页或每次响应返回的最大元素数，用于控制 API 针对特定请求返回的数据子集大小

响应参数

•︎ records object[]

DNS 资源记录数组。所有记录的通用属性如下所列

•︎ name string

DNS 记录名称是指与特定 DNS 记录关联的域名。它是 DNS 记录最左侧的部分，用于指定该记录所适用的主机或子域名。如果名称指向根（apex）域名，且主机/子域名部分应为空，则使用值 @。

•︎ type string

DNS（域名系统）记录类型是 DNS 区域文件中的特定条目，用于将域名映射到相应的 IP 地址，或提供其他类型的信息。

•︎ ttl number

DNS TTL 表示生存时间（Time to Live，单位为秒）。它是域名系统（DNS）记录中的一项设置，决定 DNS 解析器应将信息缓存多长时间，之后才需要从权威 DNS 服务器重新获取。TTL 以秒为单位，有助于管理 DNS 缓存，并确保在整个互联网上高效地完成 DNS 解析。最小值：60。最大值：32767

类型定义

•︎ A object

A：32 位 IPv4 地址，通常用于指定主机名与 IP 地址之间的对应关系。

•︎ address string

IPv4 地址

•︎ AAAA object

AAAA：128 位 IPv6 地址，用于指定主机名与 IP 地址之间的对应关系。

•︎ address string

IPv6 地址

•︎ CNAME object

CNAME 是域名系统（DNS）中的一种资源记录类型，用于表示某个名称是另一个名称（规范域名）的别名。

CNAME 记录必须始终指向另一个域名，而不能指向 IP 地址。

该别名的其他记录（包括 MX 记录等）的所有信息都将从规范域名获取。对于给定的域名，CNAME 记录必须是唯一的记录，并且根据规范，不允许在区域的根域名上使用 CNAME。

•︎ target string

完全限定域名。该值可以包含 @，表示根域名。例如，对于域名 example.com，CNAME 目标 www.@ 将显示为 www.example.com。

•︎ MX object

MX（邮件交换）是域名系统（DNS）中的一种资源记录类型，用于指定负责处理该域名邮件的邮件服务器，以及存在多台服务器时各服务器的优先级。

•︎ priority number

priority 字段指定向特定域名投递邮件时使用邮件服务器的顺序。优先级值较低的邮件服务器会被优先尝试；如果它们不可用或无法访问，则尝试优先级值较高的服务器。

•︎ exchange string

exchange 字段指定负责代表该域名接收电子邮件的邮件服务器的域名。

•︎ TXT object

TXT（文本记录）是域名系统（DNS）中的一种资源记录类型，用于指定有关域名的附加信息；这些数据通常不仅供软件使用，也供人阅读。

例如，此记录用于为邮件服务器指定 SPF（Sender Policy Framework）策略。

•︎ value string

指与记录关联的文本数据。此文本数据可以包含域名持有人希望写入 DNS 记录的任意信息。TXT 记录通常有多种用途，例如电子邮件服务的域名验证、用于电子邮件身份验证的 SPF 记录、用于电子邮件安全的 DKIM 记录，以及配置或验证域名所需的其他文本信息。

•︎ SRV object

SRV（服务记录）通常用于发现与域名关联的服务。此记录包含主机名、端口以及发现服务所需的其他数据。

•︎ service string

指定要为其创建该条目的目标服务的符号名称。该值必须以下划线 _ 开头。此字段标识 SRV 记录所定义的具体服务或协议。SRV 记录中常用的服务名称示例包括：用于 SIP（会话发起协议）服务的“_sip”、用于 LDAP（轻量级目录访问协议）服务的“_ldap”、用于 XMPP（可扩展消息与存在协议）服务的“_xmpp”等。

•︎ proto string

该字段指定记录中所定义服务使用的传输协议。该值必须以下划线 _ 开头，例如 _tcp。此字段表示该服务使用 TCP（传输控制协议）、UDP（用户数据报协议）还是其他传输协议进行通信。

•︎ priority number

指定 SRV 条目中目标主机的优先级。当某项服务有多个主机可用时，它决定使用这些目标主机的顺序

•︎ weight number

与 priority 字段配合使用，用于在优先级相同的多条 SRV 记录之间实现负载均衡。“weight”字段表示某条 SRV 记录相对于其他相同优先级 SRV 记录的相对权重

•︎ port number

指定该条目中的服务可用的 TCP 或 UDP 端口号。

•︎ target string

指定提供该服务的目标主机的域名。此字段包含提供 SRV 记录中所指定服务的服务器主机名

•︎ CAA object

CAA 允许 DNS 域名的持有人指定一个或多个有权为该域名签发证书的证书颁发机构（CA）。

•︎ value string

属性值：对于 issue、issuewild、issuemail 和 issuevmc，为获准为该域名颁发此类证书的 CA（证书颁发机构）的域名；对于 iodef，为接收违规报告的 URL（例如 mailto: 地址）。

•︎ tag enum

指定与 CAA 记录关联的属性类型

issue 指定获准为域名颁发证书的证书颁发机构

issuewild 指定获准为域名颁发通配符证书的证书颁发机构

iodef 指定证书颁发机构报告策略违规时所使用的电子邮箱地址

issuemail 扩展（RFC 9495），用于授权证书颁发机构为域名颁发 S/MIME（电子邮件）证书

issuevmc 非标准扩展，用于授权证书颁发机构为域名颁发 VMC（经验证标志证书），该证书可让支持 BIMI（邮件品牌标识）的电子邮件客户端显示品牌徽标

•︎ NS object

NS：此类记录指定域名的权威 DNS 服务器（该服务器保存最新的 DNS 记录）。域名通常会委派给多台 DNS 服务器，并拥有多条分别指向主服务器和备用服务器的 NS 记录。

Regery 禁止为区域的根域名创建 NS 记录。如需为根域名设置 DNS 服务器，请使用操作 > 修改 DNS 服务器。

•︎ ns string

指 DNS 服务器的域名

•︎ ALIAS object

ALIAS：与 CNAME 记录类似，它将别名与另一个域名（规范域名）关联。

DNS 规范中并未直接定义此类记录，与 CNAME 不同，它允许您同时设置其他类型的记录。例如，如果 DNS 客户端请求 AAAA 记录，而别名域名上不存在该记录，系统会以递归方式向规范域名请求。如果 AAAA 记录存在，则直接返回其值，不进行递归查询。

•︎ target string

完全限定域名。该值可以包含 @，表示根（apex）域名。例如，对于 apex 域名 example.com，目标 www.@ 将显示为 www.example.com。

外部 API