清单

镜像仓库清单(BackupStorage inventory)


名字	描述	可选的	可选的参数值	起始支持版本
uuid	请参见资源属性			0.6
name	请参见资源属性			0.6
description	请参见资源属性	是		0.6
url	请参见 url			0.6
totalCapacity	字节为单位的磁盘总容量, 请参见 capacity			0.6
availableCapacity	字节为单位的磁盘可用容量, 请参见 capacity			0.6
type	镜像服务器类型		Ceph ImageStoreBackupStorage VCenter SftpBackupStorage	0.6
state	请参见 state		Enabled Disabled	0.6
status	请参见 status		Connecting Connected Disconnected	0.6
attachedZoneUuids	镜像服务器所挂载的所有区域的uuid			0.6
createDate	请参见资源属性			0.6
lastOpDate	请参见资源属性			0.6

示例

{
    "inventories": {
            "attachedClusterUuids": [
                "967a353c2893409dab9312cf3033a98c"
            ],
            "availableCapacity": 163634831360,
            "availablePhysicalCapacity": 186066427904,
            "createDate": "Oct 30, 2017 3:05:29 PM",
            "description": "",
            "lastOpDate": "Oct 31, 2017 10:41:26 AM",
            "mountPath": "/Cloud_ps",
            "name": "LS-1",
            "state": "Enabled",
            "status": "Connected",
            "systemUsedCapacity": 9330311168,
            "totalCapacity": 205177397248,
            "totalPhysicalCapacity": 205177397248,
            "type": "LocalStorage",
            "url": "/Cloud_ps",
            "uuid": "037bd212f7a1488da4f94360ccfaf6ab",
            "zoneUuid": "e59b71e99d8a4ea1952b578388b8cd1d"
        }
}

镜像复制组清单(ImageReplicationGroup inventory)


名字	描述	可选的	可选的参数值	起始支持版本
uuid	请参见资源属性			3.5.0
name	请参见资源属性			3.5.0
description	请参见资源属性	是		3.5.0
state	状态		Enabled Disabled	3.5.0
backupStorageRefs	镜像组列表			3.5.0
groupBy	以字段分组，相当于MySQL中的group by关键字。例如groupBy=type	是		3.5.0
createDate	请参见资源属性			3.5.0
lastOpDate	请参见资源属性			3.5.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是		3.5.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是		3.5.0

示例

{
  "inventories": [
    {
      "uuid": "31cbc4dad8da3ca6a6e3df5c1d5f233e",
      "name": "test"
    }
  ]
}

统一资源定位符（URL）

镜像服务器需要使用URL字符串存储的信息来控制存储系统。虽然名字叫URL，具体的字符串存储格式依据主存储的类型而定，并不完全等同于标准的URL规范，这样可以给插件更多的灵活性以存储一些不方便以URL格式存储的信息。

SFTP镜像服务器URL（SFTP Backup Storage URL）

对于SFTP镜像服务器（也称，备份存储）而言，URL是一个目录在文件系统中的绝对路径。例如， /storage/sftp。

容量（Capacity）

为了方便选择合适的镜像服务器存放镜像，ZStack Cloud会监控镜像服务器的容量。镜像服务器的容量根据下面公式来计算：

总容量 = 镜像服务器的总容量
可用容量 = 总容量 - sum(镜像的实际大小)

可用状态（State）

镜像服务器有两种可用状态：

Enabled：
启用（Enabled）状态下，允许镜像被注册、备份和下载。
Disabled：
禁用（Disabled）状态下，不允许镜像被注册、备份和下载。需要特别注意的是，如果一个镜像只存在于一个禁用了的镜像服务器中，并且这个镜像还没有被下载到主存储的镜像缓存中，这时不能从这个镜像创建云主机。

连接状态（Status）

镜像服务器的连接状态反映了管理节点和备份存储之间的命令通道的状态。

Connecting：
在这种状态时，一个ZStack Cloud管理节点正在尝试建立自己和镜像服务器之间的命令通道。这时还不能在镜像服务器上执行任何操作。
Connected：
这种状态时，ZStack Cloud管理节点和镜像服务器之间的命令通道已经被成功建立。可以在镜像服务器上执行操作。
Disconnected：
在这种状态时，ZStack Cloud管理节点和镜像服务器之间的命令通道丢失。这时不能在镜像服务器上执行任何操作。

在ZStack Cloud管理节点启动过程中会开始和镜像服务器建立命令通道，并且会在运行中周期性的向镜像服务器发送ping命令（ping commands）以检查命令通道的健康状态；一旦某个镜像服务器响应失败，或者ping命令超时，镜像服务器的连接状态就会变为Disconnected。

镜像服务器的可用状态转换图如Figure 1所示：