4.2 公网 Zone 管理
4.2.1 创建公网 Zone
功能介绍
创建单个公网Zone。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/zones
请求
● 参数说明
表4-9 请求样例的参数说明
名称 是否必选 参数类
型
说明
name 是 String 从域名注册商处获得的授权域名。
● 若以“.”号结束，总长度不超过 254个字符。
● 若以非“.”号结束，总长度不超 过253个字符。
● 单个字符串不超过63个字符，字 符串间以点号分割。
域名格式不区分大小写，系统会将 输入的大写字母统一转换为小写。
description 否 String 域名的描述信息。长度不超过255个 字符。
默认值为空。
名称 是否必选 参数类 型
说明
zone_type 否 String 域名类型，包括公网域名和内网域 名。
● 公网域名（public）：域名可以 被internet上的主机访问。
● 内网域名（private）：域名仅被 具体VPC内的主机访问。
取值范围：public、private。
如果为空，则默认为public。创建内 网域名，请参见创建内网Zone。
email 否 String 管理该zone的管理员邮箱。
默认值为售后服务邮箱。
ttl 否 Integer 用于填写默认生成的SOA记录中有 效缓存时间，以秒为单位。
取值范围：1~2147483647。
默认值为300s。
tags 否 Array of
object 资源标签。详细信息请参见表 4-10。
默认值为空。
enterprise_projec
t_id 否 String 域名关联的企业项目ID，长度不超
过36个字符。
默认值为0。
表4-10 tags 对象参数说明
名称 是否必选 参数类
型
说明
key 是 String 键。最大长度36个unicode字符。
key不能为空。不能包含“=”、
“*”、“<”、“>”、“\”、
“,”、“|”和“/”，且首尾字符 不能为空格。
value 否 String 值。每个值最大长度43个unicode字 符，可以为空字符串。 不能包含
“=”、“*”、“<”、“>”、
“\”、“,”、“|”和“/”，且首 尾字符不能为空格。
● 请求样例
创建一个公网Zone，域名为“example.com”。
POST https://{DNS_Endpoint}/v2/zones
{ "name": "example.com.",
"description": "This is an example zone.", "zone_type": "public",
"email": "[email protected]", "ttl": 300,
"tags": [ {
"key": "key1", "value": "value1"
} ] }
响应
● 要素说明
表4-11 响应样例的要素说明
名称 参数类型 说明
id String zone的ID，uuid形式的一个资源标识。
name String zone名称。
description String 对zone的描述信息。
email String 管理该zone的管理员邮箱。
zone_type String zone类型，公网（public）或者内网
（private）。
ttl Integer 该zone下SOA记录中的ttl值。
serial Integer 该zone下SOA记录中用于标识zone文件变更的 序列值，用于主从节点同步。
该参数暂未使用。
status String 资源状态。
详细信息请参见资源状态。
record_num Integer 该zone下的recordset个数。
pool_id String 托管该zone的pool，由系统分配。
project_id String zone所属的项目ID。
created_at String 创建时间。
采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
updated_at String 更新时间。
采用UTC时间格式，格式为：YYYY-MM-DDTHH:MM:SSZ
links Object 指向当前资源或者其他资源的链接。当查询需要 分页时，需要包含一个next链接指向下一页。
详细信息请参见表4-12。
名称 参数类型 说明 enterprise_
project_id String 域名关联的企业项目ID，长度不超过36个字符。
masters Array of
strings 主从模式中，从DNS服务器用以获取DNS信息。
目前暂未使用。
表4-12 links 对象参数说明
名称 参数类型 说明
self String 当前资源的链接。
next String 下一页资源的链接。
● 响应样例
{ "id": "2c9eb155587194ec01587224c9f90149", "name": "example.com.",
"description": "This is an example zone.", "email": "[email protected]",
"ttl": 300, "serial": 1, "masters": [],
"status": "PENDING_CREATE", "links": {
"self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149"
},
"pool_id": "00000000570e54ee01570e9939b20019", "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c", "zone_type": "public",
"created_at": "2016-11-17T11:56:03.439", "updated_at": null,
"record_num": 0 }
返回值
接口正常的返回值为2xx，例如200、202或者204。
返回值含义以及更多返回值请参考状态码。