区域

概览

区域（Zone）：云平台内最大的一个资源定义，包括：集群、二层网络、主存储等资源。

功能原理

在数据中心中，区域一般对应了一个机房。
区域定义了一个可见的边界，同一区域内的子资源互相可见并且可以形成某种关系，但不同区域内的子资源是不可见的，不能互相发生关系。

功能特点

区域隔离：
支持区域物理隔离，不同区域的主存储、物理机等物理子资源不互通，确保最大程度的稳定性和容错性。
可减少网络时延，提高访问速度。
资源管控：
每个区域可设置平台管理员。一个平台管理员可管理一个或多个区域。
每个项目的资源只能属于一个区域。
全局查看：
规划区域后，可在单独大屏查看某区域内所有的资源。支持按照KVM/vCenter分类进行查看资源使用情况。

注意事项

规划区域时，需注意：

同一个物理二层广播域中的物理机应该在同一个区域，可属于同一个集群或分属于多个集群。
同一个物理二层广播域不应该跨越多个区域，而应该映射为单个区域的二层网络。
同一个主存储不应该跨越多个区域，而应该映射为单个区域的主存储。
一个数据中心可以有多个区域。
一个区域可以加载一个或多个镜像服务器。
- 一个区域中的资源，例如主存储，只能访问加载在同一区域中的镜像服务器。
- 一个镜像服务器可以从一个区域中删除。删除后，区域中的资源不能再看见该镜像服务器。
- 当数据中心的网络拓扑改变导致一个镜像服务器不能再被一个区域中的资源访问时，可以将镜像服务器从区域中卸载。
- UI界面为便于管理镜像服务器和区域的关系，特别设置了一个镜像服务器在同一时间内只能加载到一个区域不能再加载到其它区域。UI界面上，添加镜像服务器，默认会加载到当前区域。删除区域的同时会直接删除加载此区域的镜像服务器。

清单

属性（Properties）

名字	描述	可选的	可选的参数值	起始支持版本
uuid	请参见资源属性			0.6
name	请参见资源属性			0.6
description	请参见资源属性	是		0.6
state	请参见资源属性		Enabled Disabled	0.6
createDate	请参见资源属性			0.6
lastOpDate	请参见资源属性			0.6
type	保留域			0.6
userTags	用户标签, 请参见创建用户标签(CreateUserTag)；资源类型是 ZoneVO	是		0.6
systemTags	系统标签, 请参见创建系统标签(CreateSystemTag)；资源类型是 ZoneVO	是		0.6

示例

 {
            "createDate": "Oct 16, 2017 2:11:40 PM",
            "description": "",
            "lastOpDate": "Oct 24, 2017 10:52:31 AM",
            "name": "SH",
            "state": "Enabled",
            "type": "zstack",
            "uuid": "61092e77aedd41f0b8857b40652e5b1e"
 }

可用状态（State）

区域拥有两种可用状态：启用（Enabled）和禁用（Disabled）；
当改变一个区域的可用状态时，这个操作会被迭代（cascaded）到归属于这个区域的所有的集群和物理主机；
例如，禁用一个区域会导致所有这个区域中的集群和物理主机被禁用。由于在已经禁用的物理主机上不能创建或者启动云主机，禁用一个区域可以避免在这个区域中创建或者启动任何云主机。但不影响已有的云主机正常使用及重启操作。

操作（Operations）

创建区域（CreateZone）

管理员可以使用CreateZone命令来创建一个新的区域。例如：

CreateZone name='San Jose Zone' description='this is a zone in San Jose datacenter'

参数（Parameters）

名字	描述	可选的	起始支持版本
name	资源名字，请参见资源属性		0.6
resourceUuid	资源uuid，请参见资源属性	是	0.6
description	资源描述，请参见资源属性	是	0.6
type	保留域，请不要使用它	是	0.6
userTags	用户标签，请参见创建用户标签(CreateUserTag)；资源类型是 ZoneVO	是	0.6
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)；资源类型是 ZoneVO	是	0.6
timeout		是

删除区域（DeleteZone）

管理员可以使用DeleteZone命令来删除一个区域。例如：

DeleteZone uuid=28e94936284b45f99842ababfc3f976d

参数（parameters）

名字	描述	可选的	可选的参数值	起始支持版本
uuid	区域 uuid			0.6
deleteMode	请参见删除资源(DeleteResources)	是	Permissive Enforcing	0.6
userTags	用户标签，请参见创建用户标签(CreateUserTag)；资源类型是 ZoneVO	是		0.6
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)；资源类型是 ZoneVO	是		0.6
timeout		是

查询区域（QueryZone）

管理员可以使用QueryZone来查询区域。例如：

QueryZone name=zone1

QueryZone vmInstance.uuid=13238c8e0591444e9160df4d3636be82

原生域查询（Primitive Fields of Query）

请参见zone inventory

嵌套域和扩展域查询（Nested And Expanded Fields of Query）

域（Field）	清单（Inventory）	描述	起始支持版本
vmInstance	vm inventory	属于这个区域的云主机	0.6
cluster	cluster inventory	属于这个区域的集群	0.6
host	host inventory	属于这个区域的物理主机	0.6
primaryStorage	primary storage inventory	属于这个区域的主存储	0.6
l2Network	L2 network inventory	属于这个区域的L2网络	0.6
l3Network	L3 network inventory	属于这个区域的L3网络	0.6
backupStorage	backup storage inventory	属于这个区域的镜像服务器	0.6

更新区域（UpdateZone）

管理员可以使用UpdateZone命令来更新区域的名称、描述和标签。例如：

UpdateZone uuid=61092e77aedd41f0b8857b40652e5b1e name=update

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	区域 uuid		0.6
name	资源名字，请参见资源属性	是	0.6
description	资源描述，请参见资源属性	是	0.6
userTags	用户标签，请参见创建用户标签(CreateUserTag)；资源类型是 ZoneVO	是	0.6
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)；资源类型是 ZoneVO	是	0.6
timeout		是

更改区域的可用状态（ChangeZoneState）

管理员可以使用ChangeZoneState命令来改变区域的可用状态。例如：

ChangeZoneState stateEvent=enable uuid=737896724f2645de9372f11b13a48223

参数（Parameters）

名字	描述	可选的	可选的参数值	起始支持版本
uuid	区域 uuid			0.6
stateEvent	状态触发事件。 enable：改变可用状态为启用（Enabled） disable：改变可用状态为禁用（Disabled）		enable disable	0.6
userTags	用户标签，请参见创建用户标签(CreateUserTag)；资源类型是 ZoneVO	是		0.6
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)；资源类型是 ZoneVO	是		0.6
timeout		是

标签（Tags）

管理员可以使用resourceType=ZoneVO在区域上创建用户标签。例如：

CreateUserTag resourceType=ZoneVO resourceUuid=0cd1ef8c9b9e0ba82e0cc9cc17226a26 tag=privateZone

系统标签（System Tags）

保留容量（Reserved Capacity）

标签（Tag）	描述	示例	起始支持版本
host::reservedMemory::{capacity}	请参见物理主机容量保留（Host Capacity Reservation）	host::reservedMemory::1G	0.6