4.3 内网 Zone 管理
4.3.8 修改内网 Zone
"pool_id": "ff8080825ab738f4015ab7513298010e", "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c", "zone_type": "private",
"created_at": "2017-04-22T10:05:23.110", "updated_at": "2017-04-22T10:05:23.959", "record_num": 0,
"routers": [ {
"status": "ACTIVE",
"router_id": "19664294-0bf6-4271-ad3a-94b8c79c6558", "router_region": "xx"
}, {
"status": "ACTIVE",
"router_id": "f0791650-db8c-4a20-8a44-a06c6e24b15b", "router_region": "xx"
} ] }
返回值
接口正常的返回值为2xx，例如200、202或者204。
返回值含义以及更多返回值请参考状态码。
4.3.8 修改内网 Zone
功能介绍
修改单个Zone。
调试
您可以在API Explorer中调试该接口。
URI
PATCH /v2/zones/{zone_id}
参数说明请参见表4-68。
表4-68 URI 格式的参数说明
名称 是否必选 参数类型 说明
zone_id 是 String 待修改zone的ID。
可以通过查询内网Zone列表获取。
请求
● 参数说明
表4-69 请求样例的参数说明
名称 是否必选 参数类型 说明
descripti
on 否 String 域名的描述信息。长度不超过255个字
符。
如果为空，表示维持原值。
默认值为空。
email 否 String 管理该zone的管理员邮箱。
如果为空，表示维持原值。
默认值为空。
ttl 否 Integer 用于填写默认生成的SOA记录中有效缓 存时间，以秒为单位。
取值范围：
1~2147483647。
如果为空，表示维持原值。
默认值为空。
● 请求样例
修改Zone ID为“2c9eb155587194ec01587224c9f90149”的域名信息。
PATCH https://{DNS_Endpoint}/v2/zones/2c9eb155587194ec01587224c9f90149 { "description": "This is an example zone.",
"email": "[email protected]", "ttl": 300
}
响应
● 要素说明
表4-70 响应样例的要素说明
名称 参数类型 说明
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-71。
masters Array of
strings 主从模式中，从DNS服务器用以获取DNS信息。
目前暂未使用。
routers Array of
object Private zone关联的Router(VPC)信息。详细信 息请参见表4-72。
表4-71 links 参数说明
名称 参数类型 说明
self String 当前资源的链接。
next String 下一页资源的链接。
表4-72 routers 对象参数说明
名称 参数类型 说明
status String 资源状态。
详细信息请参见资源状态。
router_id String Router(VPC)所属VPC的ID。
该参数的值可以通过如下两种方式获取：
● 通过虚拟私有云的管理控制台，在VPC的详 情页面中获取VPC的ID。
● 通过查询VPC列表获取VPC ID。
router_regio
n String Router(VPC)所在的region。
如果为空，默认为token中project所在的 region。
● 响应样例
{ "id": "ff8080825b8fc86c015b94bc6f8712c3", "name": "example.com.",
"description": "This is an example zone.", "email": "[email protected]",
"ttl": 300, "serial": 1, "masters": [], "status": "ACTIVE", "links": {
"self": "https://Endpoint/v2/zones/ff8080825b8fc86c015b94bc6f8712c3"
},
"pool_id": "ff8080825ab738f4015ab7513298010e", "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c", "zone_type": "private",
"created_at": "2017-04-22T08:17:08.997", "updated_at": "2017-04-22T08:17:10.849", "record_num": 2,
"routers": [ {
"status": "ACTIVE",
"router_id": "19664294-0bf6-4271-ad3a-94b8c79c6558", "router_region": "xx"
} ] }
返回值
接口正常的返回值为2xx，例如200、202或者204。
返回值含义以及更多返回值请参考状态码。