调用AddRecursionRecord接口新增HTTPDNS内置权威解析记录-云解析DNS-阿里云-云解析DNS(DNS)-阿里云帮助中心

新增递归解析内置权威解析记录。

接口说明

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

pubdns:AddRecursionRecord

create

*recursionZone

acs:pubdns::{#accountId}:recursionZone/{#zoneId}

无

请求参数

名称	类型	必填	描述	示例值
UserClientIp	string	否	用户端 IP。	192.168.0.1
ZoneId	string	是	Zone ID。	173671468000011
Rr	string	否	主机记录。主机记录就是域名前缀，常见用法有 www、@、*（泛解析）、mail（常用于邮箱）。例如要解析@.exmaple.com，主机记录要填写"@”，而不是空。	www
Type	string	否	解析记录类型，目前支持如下： A:IPV4 记录，支持将域名映射到 IPv4 地址使用 AAAA:IPV6 记录，支持将域名映射到 IPv6 地址使用 CNAME:别名记录，支持将域名指向另外一个域名 MX:电邮交互记录，支持将域名指向邮件服务器地址 TXT:文本记录，是任意可读的文本 DNS 记录 SRV:服务器资源记录，用来标识某台服务器使用了某个服务，常见于微软系统的目录管理 NS:名称服务器记录，支持将子域名委托给其他 DNS 服务商解析 CAA:CAA 资源记录，可以限定域名颁发证书和 CA（证书颁发机构）之间的联系 URL:将域名指向另外一个已经存在的站点 SVCB:服务绑定记录，主要用于服务发现，以 DNS 记录的方式披露服务支持的协议和服务参数信息 HTTPS:针对 HTTPS 服务的特定记录类型，使用 HTTPS 记录，可约定安全的 HTTPS 建连协议，以及最优的服务站点地址	A
RequestSource	string	否	解析线路，默认为 default。参见：解析线路枚举	default
Weight	integer	否	权重值（1-100 内的整数，包括 1 和 100，默认为 1），支持对每个地址设置不同的权重值，实现解析查询按照权重比例返回地址。	2
Priority	integer	否	MX 记录的优先级。取值越小，优先级越高，取值范围：[1,99]。	1
Ttl	integer	否	本地缓存时间。目前取值仅支持 5、30、60、3600（1 小时）、43200（12 小时）、86400（24 小时），单位秒（s），默认 60。	60
Value	string	否	记录值。根据不同解析记录类型，填写相应的记录值。	1.1.1.1
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。	6447728c8578e66aacf062d2df4446dc

返回参数

名称	类型	描述	示例值
	object
RequestId	string	唯一请求识别码。	29D0F8F8-5499-4F6C-9FDC-1EE13BF55925
Success	boolean	本次操作是否成功： true：成功。 false：失败。	true
RecordId	string	解析记录的 ID。	173671468000010

示例

正常返回示例

JSON格式

{
  "RequestId": "29D0F8F8-5499-4F6C-9FDC-1EE13BF55925",
  "Success": true,
  "RecordId": "173671468000010"
}

错误码

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

变更历史

更多信息，参考变更详情。