AddZone - 添加zone_云解析DNS(DNS)-阿里云帮助中心

接口说明

2025 年 4 月 30 日（UTC+8）起，新开通云解析 PrivateZone 的用户在添加 Zone 时，默认将设置为加速区 Zone。 2025 年 10 月 30 日（UTC+8）起，所有用户的普通区内置权威 Zone 将自动切换至加速区。切换后解析请求量可能增加，导致使用成本上升。建议为ECS 开启 NSCD，以减少无本地缓存引发的解析请求增长。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

pvtz:AddZone

create

*Zone

acs:pvtz::{#accountId}:zone/*

无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	返回值语言，取值： zh：中文。 en：英文。默认：en	en
ZoneName	string	否	需要新增的 zone 名称。	example.com
ProxyPattern	string	否	是否开启子域名递归代理。取值： ZONE: 关闭（当解析本域名下不存在的子域名时，直接返回 NXDOMAIN，表示子域名不存在） RECORD: 开启（当解析本域名下不存在的子域名时，会依次查询“转发”和“递归”模块，并以最终查询到的解析结果来应答解析请求）默认：ZONE	ZONE
ResourceGroupId	string	否	资源组 ID。	rg-acfmykd63gt****
ZoneType	string	否	暂不对用户开放，无需传值。	CLOUD_PRODUCT_ZONE
ZoneTag	string	否	暂不对用户开放，无需传值。	BLINK
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持 ASCII 字符，且不能超过 64 个字符。	21079fa016944979537637959d09bc
DnsGroup	string	否	内置权威位置区。取值： NORMAL_ZONE：普通区（解析应答结果会被缓存，缓存不命中的情况下才回源到内置权威普通区，解析变更生效受 TTL 时间影响；无法使用自定义线路解析、权重解析功能。） FAST_ZONE：快速区（推荐：直接应答解析请求、解析时延最低，记录变更实时生效；支持自定义线路解析、权重解析。）默认：NORMAL_ZONE 说明内置权威加速区在缓存模块前，解析结果不进入缓存，因此将产生更多解析量请求费用。说明 2025 年 4 月 30 日（UTC+8）起，新开通云解析 PrivateZone 的用户在添加 Zone 时，默认将设置为加速区 Zone。	FAST_ZONE

返回参数

名称	类型	描述	示例值
	object
ZoneName	string	zone 名称。	example.com
ZoneId	string	Zone ID，Zone 的唯一识别码。	6fc186295683a131f63bb8b0cddc****
RequestId	string	唯一请求识别码。	54F10A2A-C3CF-59D4-810F-F18DDD93FE20
Success	boolean	是否成功。	true

示例

正常返回示例

JSON格式

{
  "ZoneName": "example.com",
  "ZoneId": "6fc186295683a131f63bb8b0cddc****",
  "RequestId": "54F10A2A-C3CF-59D4-810F-F18DDD93FE20",
  "Success": true
}

错误码

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

变更历史

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