云盘规格

概览

云盘规格：云盘涉及的容量大小的规格定义。

云盘规格可以用来创建根云盘和数据云盘。

清单

属性

名字	描述	可选的	可选的参数值	起始支持版本
uuid	请参见资源属性			0.6
name	请参见资源属性			0.6
description	请参见资源属性	是		0.6
diskSize	单位为字节的云盘大小, 请参见 disk size			0.6
state	请参见 state		Enabled Disabled	0.6
type	保留的域		zstack	0.6
allocatorStrategy	请参见 allocator strategy		DefaultHostAllocatorStrategy LastHostPreferredAllocatorStrategy LeastVmPreferredHostAllocatorStrategy MinimumCPUUsageHostAllocatorStrategy MinimumMemoryUsageHostAllocatorStrategy MaxInstancePerHostHostAllocatorStrategy	0.6
sortKey				0.6
createDate	请参见资源属性			0.6
lastOpDate	请参见资源属性			0.6

示例

{
    "inventories": [
        {
            "allocatorStrategy": "DefaultPrimaryStorageAllocationStrategy",
            "createDate": "Oct 30, 2017 3:09:45 PM",
            "description": "",
            "diskSize": 10737418240,
            "lastOpDate": "Oct 30, 2017 3:09:45 PM",
            "name": "10G",
            "sortKey": 0,
            "state": "Enabled",
            "type": "DefaultDiskOfferingType",
            "uuid": "6c2385bb60f84c269504ca6ea71fe2d1"
        }
    ],
    "success": true
}

云盘大小（Disk Size）

DiskSize定义了云盘的虚拟大小（virtual size）。虚拟大小是指云盘声明的大小，也就是云盘完全填满后的在存储系统中所占的大小。

可用状态（State）

云盘规格有两种可用状态：

Enabled：
启用（Enabled）状态下，允许从云盘规格创建云盘。
Disabled：
禁用（Disabled）状态下，不允许从云盘规格创建云盘。

分配策略（Allocator Strategy）

分配策略定义了ZStack Cloud怎么选择用于创建新云盘的主存储。ZStack Cloud当前版本仅支持寻找满足下列条件主存储的DefaultPrimaryStorageAllocationStrategy策略：

1. 可用状态为启用（Enabled）
2. 连接状态为已连接（Connected）
3. 可用容量（availableCapacity）比云盘规格的diskSize大
4. 已挂载到云盘将要挂载的云主机所在的集群

操作（Operations）

创建云盘规格（CreateDiskOffering）

管理员可以使用CreateDiskOffering创建云盘规格。例如：

CreateDiskOffering name=test diskSize=100

参数（Parameters）

名字	描述	可选的	可选的参数值	起始支持版本
name	云盘规格名称			0.6
description	云盘规格的详细描述	是		0.6
diskSize	云盘大小			0.6
allocatorStrategy	分配策略	是	DefaultHostAllocatorStrategy LastHostPreferredAllocatorStrategy LeastVmPreferredHostAllocatorStrategy MinimumCPUUsageHostAllocatorStrategy MinimumMemoryUsageHostAllocatorStrategy MaxInstancePerHostHostAllocatorStrategy LeastVolumePrimaryStorageAllocationStrategy MaximumAvailableCapacityAllocationStrategy CustomOrderPrimaryStorageAllocationStrategy	0.6
sortKey	排序键	是		0.6
type	类型	是		0.6
resourceUuid	资源uuid。若指定，镜像会使用该字段值作为uuid	是		0.6
userTags	用户标签，请参见创建用户标签(CreateUserTag)；资源类型是 DiskOfferingVO	是		0.6
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)；资源类型是 DiskOfferingVO	是		0.6
timeout		是

Note:

ZStack Cloud创建云盘规格时支持自定义云盘规格参数，SystemTags增加diskOfferingUserConfig选项。

选项格式为：


                                        diskOfferingUserConfig::xxx

，XXX要求JSON字符串。

例如，为云盘规格指定多个主存储：diskOfferingUserConfig::

{
    "allocate": {
        "primaryStorages":[
            {
                "type":"输入主存储类型",
                "uuid":"输入主存储UUID"
            },
            {
                "type":"输入主存储类型",
                "uuid":"输入主存储UUID"
            },
            {
                "type":"输入主存储类型",
                "uuid":"输入主存储UUID"
            }
        ]
    }

}

删除云盘规格（DeleteDiskOffering）

管理员可以使用DeleteDiskOffering删除云盘规格。例如：

DeleteDiskOffering uuid=84c05965795140439e86592d2fa1c965

参数（Parameters）

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

查询云盘规格（QueryDiskOffering）

管理员可以使用QueryDiskOffering查询云盘规格。例如：

QueryDiskOffering diskSize>=10000000

QueryDiskOffering volume.name=data1

原生域查询（Primitive Fields of Query）

请参见 instance offering inventory

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

域（Field）	清单（Inventory）	描述	起始支持版本
volume	volume inventory	由该云盘规格创建的云盘	0.6

更改云盘规格的启用状态（ChangeDiskOfferingState）

管理员可以使用ChangeDiskOfferingState更改云盘规格的启用状态。例如：

ChangeDiskOfferingState uuid=c9dd395cb5f04f4ba9eb1e62b886fe62 stateEvent=enable

参数（Parameters）

名字	描述	可选的	可选的参数值	起始支持版本
uuid	云盘规格uuid			0.6
stateEvent	状态事件		enable disable	0.6
userTags	用户标签，请参见创建用户标签(CreateUserTag)；资源类型是 DiskOfferingVO	是		0.6
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)；资源类型是DiskOfferingVO	是		0.6
timeout		是

更新云盘规格（UpdateDiskOffering）

管理员可以使用UpdateDiskOffering更新云盘规格。例如：

UpdateDiskOffering uuid=c9dd395cb5f04f4ba9eb1e62b886fe62 name=test

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	云盘规格uuid		0.6
name	云盘规格名称	是	0.6
description	云盘规格的详细描述	是	0.6
userTags	用户标签，请参见创建用户标签(CreateUserTag)；资源类型是 DiskOfferingVO	是	0.6
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)；资源类型是 DiskOfferingVO	是	0.6
timeout		是

标签（Tags）

用户可以使用resourceType=DiskOfferingVO在云盘规格上创建用户标签。例如：

CreateUserTag tag=smallDisk resourceType=DiskOfferingVO \
resourceUuid=d6c49e73927d40abbfcf13852dc18367

系统标签（System Tags）

专用主存储（Dedicated Primary Storage）

当从云盘规格创建云盘的时候，用户可以通过系统标签指定从哪个主存储创建云盘。

标签	描述	示例	起始支持版本
primaryStorage::allocator::uuid::{uuid}	如果该标签存在, 从该云盘规格创建的云盘会从uuid指定的主存储分配;如果指定的主存储不存在或没有足够的容量，会报告分配失败（allocation failure）	primaryStorage::allocator::uuid::b8398e8b7ff24527a3b81dc4bc64d974	0.6
primaryStorage::allocator::userTag::{tag}::required	如果该标签存在, 从该云盘规格创建的云盘会从带有用户标签tag的主存储分配;如果指定的主存储不存在或没有足够的容量，会报告分配失败（allocation failure）	primaryStorage::allocator::userTag::SSD::required	0.6
primaryStorage::allocator::userTag::{tag}	如果该标签存在, 从该云盘规格创建的云盘会首先尝试从带有用户标签tag的主存储分配, 如果找不到带指定标签的主存储或容量不足，ZStack Cloud会随机选择一个主存储分配这个云盘	primaryStorage::allocator::userTag::SSD	0.6

如果在云盘规格上有多个上面提到的系统标签存在，它们的优先顺序是：

primaryStorage::allocator::uuid::{uuid} > primaryStorage::allocator::userTag::{tag}::required > \
primaryStorage::allocator::userTag::{tag}