清单

属性


名字	描述	可选的	可选的参数值	起始支持版本
uuid	请参见资源属性			0.6
name	请参见资源属性			0.6
description	请参见资源属性	是		0.6
state	请参见 state		Enabled Disabled	0.6
status	请参见 status		Creating Downloading Ready	0.6
size	镜像大小，单位是字节			0.6
url	镜像注册的url, 请参见 url			0.6
mediaType	镜像的媒介类型, 请参见 media type		RootVolumeTemplate DataVolumeTemplate ISO	0.6
guestOsType	该字符串描述了虚拟机的操作系统类型	是		0.6
platform	虚拟机的操作系统平台，请参见 platform		Linux Windows Paravirtualization Other	0.6
system	请参见 system image			0.6
format	请参见 format		qcow2 raw	0.6
md5Sum	镜像的md5校验值			0.6
type	保留的域		zstack	0.6
actualSize	真实大小			0.6
exportMd5Sum				0.6
exportUrl				0.6
backupStorageRefs	image backstorage ref列表			0.6
createDate	请参见资源属性			0.6
lastOpDate	请参见资源属性			0.6

示例

{
    "inventories": [
        {
            "actualSize": 293641216,
            "backupStorageRefs": [
                {
                    "backupStorageUuid": "ae840e03a0044b759b0a8c09a141a46b",
                    "createDate": "Oct 30, 2017 4:32:11 PM",
                    "imageUuid": "fccc12fee6a411d68c42763ded705630",
                    "installPath": "zstore://fccc12fee6a411d68c42763ded705630/b08ea6cad1f10217223192343a1d8fb72279ed47",
                    "lastOpDate": "Oct 30, 2017 4:32:11 PM",
                    "status": "Ready"
                }
            ],
            "createDate": "Oct 30, 2017 4:32:11 PM",
            "description": "",
            "exportMd5Sum": "9b38fe1fd43385b86a1c9b12ac1960fe",
            "exportUrl": "http://10.0.146.122:8001/imagestore/download/image-b08ea6cad1f10217223192343a1d8fb72279ed47.qcow2",
            "format": "qcow2",
            "lastOpDate": "Oct 30, 2017 7:35:38 PM",
            "md5Sum": "42e98b8fc79cd8aeffe1b34a2a7021fed621eec0be926139d46e8afc26e78b7d",
            "mediaType": "RootVolumeTemplate",
            "name": "vr-test-2",
            "platform": "Linux",
            "size": 8589934592,
            "state": "Enabled",
            "status": "Ready",
            "system": true,
            "type": "zstack",
            "url": "http://192.168.200.100/mirror/diskimages/zstack-vrouter-latest.qcow2",
            "uuid": "fccc12fee6a411d68c42763ded705630"
        }
    ],
    "success": true
}

可用状态（State）

镜像有两种状态：

Enabled：
在这种状态下，允许创建基于该镜像的云主机。
Disabled：
在这种状态下，不允许创建基于该镜像的云主机。

连接状态（Status）

连接状态反映了镜像的生命周期：

Creating：
正在从云盘创建镜像；未就绪不能使用。
Downloading：
正在从url下载镜像；未就绪不能使用。
Ready：
镜像已经在镜像服务器中；已就绪可以使用。

URL

镜像在镜像服务器中创建的方式不同，url的含义也会不同。

如果镜像是从网页服务器下载的，url就是HTTP/HTTPS链接；
如果镜像是从云盘或者云盘快照创建的， url就是云盘或云盘快照的UUID的字符串编码，例如：
```
volume://b395386bdb4a4ff1b1850a457c949c5e
volumeSnapshot://b395386bdb4a4ff1b1850a457c949c5e
```

媒介类型（Media Type）

媒介类型指示了镜像的用途。

RootVolumeTemplate：
镜像被用来创建根云盘。
DataVolumeTemplate：
镜像被用来创建数据云盘。
ISO：
镜像被用来在空白的根云盘上安装操作系统。

平台（Platform）

Zstack根据平台来判断是否要使用半虚拟化（paravirtualization）。


使用半虚拟化	Linux Paravirtualization
不使用半虚拟化（虚拟机磁盘使用IDE模式，网卡使用e1000）	Windows Other

系统镜像（System Image）

系统镜像仅被用来创建特殊应用云主机（appliance VMs），因而不被用户云主机使用。

格式（Format）

格式反映了虚拟机管理程序和镜像之间的关系。例如，qcow2格式的镜像仅能被KVM虚拟机使用。ZStack当前版本仅支持KVM虚拟机管理程序，因此关系表如下：


虚拟机管理程序类型	格式
KVM	qcow2 raw

创建的云盘会从其所基于的镜像继承格式信息。例如，从qcow2格式的镜像创建的根云盘同样会是qcow2格式。raw格式是个特例，从raw格式的镜像创建的云盘会使用qcow2格式，因为ZStack会通过qcow2格式使用thin-clone。

镜像服务器引用（Backup Storage Reference）

一个镜像可以存储在一个或多个镜像服务器中。对于所存储的每个镜像服务器，镜像都有一个包含了镜像服务器uuid以及镜像安装路径的镜像服务器引用。


名字	描述	起始支持版本
imageUuid	镜像的uuid	0.6
backupStorageUuid	镜像服务器的uuid，请参见 backup storage	0.6
installPath	在镜像服务器上的安装路径	0.6
createDate	请参见资源属性	0.6
lastOpDate	请参见资源属性	0.6

示例

{
                    "backupStorageUuid": "ae840e03a0044b759b0a8c09a141a46b",
                    "createDate": "Oct 30, 2017 4:32:11 PM",
                    "imageUuid": "fccc12fee6a411d68c42763ded705630",
                    "installPath": "zstore://fccc12fee6a411d68c42763ded705630/b08ea6cad1f10217223192343a1d8fb72279ed47",
                    "lastOpDate": "Oct 30, 2017 4:32:11 PM",
                    "status": "Ready"
                }