快照

概览

快照：某一时间点某一磁盘的数据状态文件。做重要操作前，对云主机根云盘、数据云盘、云主机内存或弹性裸金属实例做特定时间点的临时状态保留，方便出现故障后迅速回滚。如需长期备份，建议使用灾备服务。

快照类别

快照包括手动快照和自动快照两种类型：

手动快照：用户随时手动对云主机根云盘、数据云盘或弹性裸金属实例创建快照。
自动快照：通过定时任务创建快照，或系统在特定场景触发一次性自动快照。
- 通过定时任务创建快照，用户需提前创建定时快照策略，系统会在设置的时间点自动对相应资源创建快照。
- 系统在以下特定场景可能触发一次性自动快照：
  - 根云盘扩容
  - 数据云盘扩容
  - 重置云主机
  - 快照回滚
    Note:
    - 系统默认快照回滚不会触发一次性自动快照。
    - 用户可自行设置快照回滚是否触发一次性自动快照，设置方法：
      进入设置 > 平台设置 > 全局设置 > 高级设置 > 资源中心 > 云资源池 > 快照，开启自动创建云盘快照开关即可。
  - 在Ceph主存储上创建根云盘或数据云盘的镜像

快照视图

ZStack Cloud支持两种快照视图：列表视图和拓扑视图。

列表视图：以列表的方式展示快照信息，包括：快照名称、类型、容量、创建日期和支持的操作。
拓扑视图：以快照树的方式展示快照信息，包括：快照链和快照节点。支持定位到当前快照、还原画布、放大、缩写、全屏等操作。

应用场景

快照功能适用于以下应用场景：

故障迅速还原：当生产环境出现异常故障，可使用快照回滚功能迅速还原至正常状态。该手段为临时方案，考虑到数据的长期完善保护，建议使用灾备服务。
数据开发：通过对生产数据创建快照，从而为数据挖掘、报表查询和开发测试等应用提供近实时的真实生产数据。
提高操作容错率：在系统升级或业务数据迁移等重大操作前，建议创建一份或多份快照。一旦升级或者迁移过程中出现任何问题，可以通过快照及时恢复到正常的系统数据状态。

清单

快照组清单(VolumeSnapshotGroup Inventory)

名字	描述	可选的	起始支持版本
uuid	请参见资源属性		3.6.0
name	请参见资源属性		3.6.0
description	请参见资源属性	是	3.6.0
snapshotCount	组内快照数量		3.6.0
vmInstanceUuid	云主机UUID		3.6.0
volumeSnapshotRefs			3.6.0
groupBy	以字段分组，相当于MySQL中的group by关键字。例如groupBy=type	是	3.6.0
createDate	请参见资源属性		3.6.0
lastOpDate	请参见资源属性		3.6.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.6.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.6.0

示例

{
    "inventories": [
        {
            "createDate": "Sep 12, 2019 5:26:18 PM",
            "description": "",
            "lastOpDate": "Sep 12, 2019 5:26:18 PM",
            "name": "Snapshot-4",
            "snapshotCount": 2,
            "uuid": "63854129e8aa42258aa83d0d9d45032c",
            "vmInstanceUuid": "c0220ee607bf4afabc2a66532b0b0387",
            "volumeSnapshotRefs": [
                {
                    "createDate": "Sep 12, 2019 5:26:18 PM",
                    "deviceId": 1,
                    "lastOpDate": "Sep 12, 2019 5:26:18 PM",
                    "snapshotDeleted": false,
                    "volumeName": "云盘-1",
                    "volumeSnapshotGroupUuid": "63854129e8aa42258aa83d0d9d45032c",
                    "volumeSnapshotInstallPath": "/Cloud_ps/dataVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-1b746a6adb584ee89c65ab51c3634416/snapshots/2b47066db7c641019495204a39d00abb.qcow2",
                    "volumeSnapshotName": "Snapshot-4-云盘-1",
                    "volumeSnapshotUuid": "75c17cf55b2a4a70877e274d5c5ec77b",
                    "volumeType": "Data",
                    "volumeUuid": "1b746a6adb584ee89c65ab51c3634416"
                },
                {
                    "createDate": "Sep 12, 2019 5:26:18 PM",
                    "deviceId": 0,
                    "lastOpDate": "Sep 12, 2019 5:26:18 PM",
                    "snapshotDeleted": false,
                    "volumeName": "ROOT-for-VM-1",
                    "volumeSnapshotGroupUuid": "63854129e8aa42258aa83d0d9d45032c",
                    "volumeSnapshotInstallPath": "/Cloud_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-b2026ce722584b0383b247640e2961e2/snapshots/d0ea588f6c5d4e539a54ff4f64112e86.qcow2",
                    "volumeSnapshotName": "Snapshot-4-ROOT-for-VM-1",
                    "volumeSnapshotUuid": "6daba46d758445d4af7812738ba93e7d",
                    "volumeType": "Root",
                    "volumeUuid": "b2026ce722584b0383b247640e2961e2"
                }
            ]
        },
        {
            "createDate": "Sep 12, 2019 5:26:28 PM",
            "description": "",
            "lastOpDate": "Sep 12, 2019 5:26:28 PM",
            "name": "Snapshot-5",
            "snapshotCount": 2,
            "uuid": "ce6bbd10e379472886e4d74448e43066",
            "vmInstanceUuid": "c0220ee607bf4afabc2a66532b0b0387",
            "volumeSnapshotRefs": [
                {
                    "createDate": "Sep 12, 2019 5:26:28 PM",
                    "deviceId": 0,
                    "lastOpDate": "Sep 12, 2019 5:26:28 PM",
                    "snapshotDeleted": false,
                    "volumeName": "ROOT-for-VM-1",
                    "volumeSnapshotGroupUuid": "ce6bbd10e379472886e4d74448e43066",
                    "volumeSnapshotInstallPath": "/Cloud_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-b2026ce722584b0383b247640e2961e2/snapshots/6daba46d758445d4af7812738ba93e7d.qcow2",
                    "volumeSnapshotName": "Snapshot-5-ROOT-for-VM-1",
                    "volumeSnapshotUuid": "9eac8e8d51fc450d91e713bc4fdd20a2",
                    "volumeType": "Root",
                    "volumeUuid": "b2026ce722584b0383b247640e2961e2"
                },
                {
                    "createDate": "Sep 12, 2019 5:26:28 PM",
                    "deviceId": 1,
                    "lastOpDate": "Sep 12, 2019 5:26:28 PM",
                    "snapshotDeleted": false,
                    "volumeName": "云盘-1",
                    "volumeSnapshotGroupUuid": "ce6bbd10e379472886e4d74448e43066",
                    "volumeSnapshotInstallPath": "/Cloud_ps/dataVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-1b746a6adb584ee89c65ab51c3634416/snapshots/75c17cf55b2a4a70877e274d5c5ec77b.qcow2",
                    "volumeSnapshotName": "Snapshot-5-云盘-1",
                    "volumeSnapshotUuid": "88864416e95846f68b5e881cdca1eedf",
                    "volumeType": "Data",
                    "volumeUuid": "1b746a6adb584ee89c65ab51c3634416"
                }
            ]
        },
        {
            "createDate": "Sep 12, 2019 5:26:00 PM",
            "description": "",
            "lastOpDate": "Sep 12, 2019 5:26:00 PM",
            "name": "Snapshot-2",
            "snapshotCount": 2,
            "uuid": "d6939afab0824cab8e9a57a25686a7d4",
            "vmInstanceUuid": "c0220ee607bf4afabc2a66532b0b0387",
            "volumeSnapshotRefs": [
                {
                    "createDate": "Sep 12, 2019 5:26:00 PM",
                    "deviceId": 1,
                    "lastOpDate": "Sep 12, 2019 5:26:00 PM",
                    "snapshotDeleted": false,
                    "volumeName": "云盘-1",
                    "volumeSnapshotGroupUuid": "d6939afab0824cab8e9a57a25686a7d4",
                    "volumeSnapshotInstallPath": "/Cloud_ps/dataVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-1b746a6adb584ee89c65ab51c3634416/snapshots/d403f271636a488fbd25afd74ca589f8.qcow2",
                    "volumeSnapshotName": "Snapshot-2-云盘-1",
                    "volumeSnapshotUuid": "2b47066db7c641019495204a39d00abb",
                    "volumeType": "Data",
                    "volumeUuid": "1b746a6adb584ee89c65ab51c3634416"
                },
                {
                    "createDate": "Sep 12, 2019 5:26:00 PM",
                    "deviceId": 0,
                    "lastOpDate": "Sep 12, 2019 5:26:00 PM",
                    "snapshotDeleted": false,
                    "volumeName": "ROOT-for-VM-1",
                    "volumeSnapshotGroupUuid": "d6939afab0824cab8e9a57a25686a7d4",
                    "volumeSnapshotInstallPath": "/Cloud_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-b2026ce722584b0383b247640e2961e2/snapshots/ce2fe3b2faba4b32b1c2fadbd462cc6d.qcow2",
                    "volumeSnapshotName": "Snapshot-2-ROOT-for-VM-1",
                    "volumeSnapshotUuid": "400cabe156424e7282bb4606c40907dc",
                    "volumeType": "Root",
                    "volumeUuid": "b2026ce722584b0383b247640e2961e2"
                }
            ]
        },
        {
            "createDate": "Sep 12, 2019 5:25:40 PM",
            "description": "",
            "lastOpDate": "Sep 12, 2019 5:25:40 PM",
            "name": "Snapshot-1",
            "snapshotCount": 2,
            "uuid": "e5bad705d61a424aa703578f86ce8522",
            "vmInstanceUuid": "c0220ee607bf4afabc2a66532b0b0387",
            "volumeSnapshotRefs": [
                {
                    "createDate": "Sep 12, 2019 5:25:40 PM",
                    "deviceId": 1,
                    "lastOpDate": "Sep 12, 2019 5:25:40 PM",
                    "snapshotDeleted": false,
                    "volumeName": "云盘-1",
                    "volumeSnapshotGroupUuid": "e5bad705d61a424aa703578f86ce8522",
                    "volumeSnapshotInstallPath": "/Cloud_ps/dataVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-1b746a6adb584ee89c65ab51c3634416/1b746a6adb584ee89c65ab51c3634416.qcow2",
                    "volumeSnapshotName": "Snapshot-1-云盘-1",
                    "volumeSnapshotUuid": "d403f271636a488fbd25afd74ca589f8",
                    "volumeType": "Data",
                    "volumeUuid": "1b746a6adb584ee89c65ab51c3634416"
                },
                {
                    "createDate": "Sep 12, 2019 5:25:40 PM",
                    "deviceId": 0,
                    "lastOpDate": "Sep 12, 2019 5:25:40 PM",
                    "snapshotDeleted": false,
                    "volumeName": "ROOT-for-VM-1",
                    "volumeSnapshotGroupUuid": "e5bad705d61a424aa703578f86ce8522",
                    "volumeSnapshotInstallPath": "/Cloud_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-b2026ce722584b0383b247640e2961e2/b2026ce722584b0383b247640e2961e2.qcow2",
                    "volumeSnapshotName": "Snapshot-1-ROOT-for-VM-1",
                    "volumeSnapshotUuid": "ce2fe3b2faba4b32b1c2fadbd462cc6d",
                    "volumeType": "Root",
                    "volumeUuid": "b2026ce722584b0383b247640e2961e2"
                }
            ]
        }
    ],
    "success": true
}

操作（Operations）

创建快照组(CreateVolumeSnapshotGroup)

用户可以使用CreateVolumeSnapshotGroup创建快照组。例如：

CreateVolumeSnapshotGroup rootVolumeUuid=901cae4fd9f43a1ca20da4146ddaec50 name=test

参数（Parameters）

名字	描述	可选的	起始支持版本
rootVolumeUuid	根云盘UUID		3.6.0
name	资源名称		3.6.0
description	资源的详细描述	是	3.6.0
resourceUuid		是	3.6.0
tagUuids	标签UUID列表	是	3.6.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.6.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.6.0
timeout		是

删除快照组(DeleteVolumeSnapshotGroup)

用户可以使用DeleteVolumeSnapshotGroup删除快照组。例如：

DeleteVolumeSnapshotGroup uuid=f7b2175eebba3161b029689cb32f9b14

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	The resource UUID.		3.6.0
deleteMode		是	3.6.0
direction	数据合并方向。pull：向前合并；commit：向后合并；auto：自动选择最优合并方向	是	5.4.0
scope	数据合并方式。single：仅合并单个快照；chain：合并整个快照链；auto：自动判断最佳合并范围	是	5.4.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.6.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.6.0

更新快照组信息(UpdateVolumeSnapshotGroup)

用户可以使用UpdateVolumeSnapshotGroup更新快照组信息。例如：

UpdateVolumeSnapshotGroup uuid=c39089cddbd836628f346b14beafe2d3 name=test

参数（Parameters）

名字	描述	可选的	起始支持版本
name	资源名称	是	3.6.0
description	资源的详细描述	是	3.6.0
uuid	资源的UUID，唯一标示该资源		3.6.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.6.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.6.0
timeout		是

查询快照组(QueryVolumeSnapshotGroup)

管理员可以使用QueryVolumeSnapshotGroup查询快照组。例如：

QueryVolumeSnapshotGroup vmInstanceUuid=9480c1736b9c3798b3030cd990f0db8f

原生域查询（Primitive Fields of Query）

请参见快照组清单(VolumeSnapshotGroup Inventory)。

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

域（Field）	清单（Inventory）	描述	起始支持版本
volumeSnapshot	云盘快照清单(VolumeSnapshot Inventory)	快照组相关云盘快照	3.6.0
volumeSnapshotRef	Volumesnapshot inventory	快照组相关云盘快照列表	3.6.0
volumeSnapshotRefs	Volumesnapshot inventory	快照组相关云盘快照列表	3.6.0

检查快照组可用性(CheckVolumeSnapshotGroupAvailability)

用户可以使用CheckVolumeSnapshotGroupAvailability检查快照组可用性。例如：

CheckVolumeSnapshotGroupAvailability uuids=cc389f9eb3223c698f565621d2abcf72

参数（Parameters）

名字	描述	可选的	起始支持版本
uuids	快照组UUIDs		3.6.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.6.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.6.0
timeout		是

恢复快照组(RevertVmFromSnapshotGroup)

用户可以使用RevertVmFromSnapshotGroup恢复快照组。例如：

RevertVmFromSnapshotGroup uuid=37050441a903313297e65e09ccbeb30f

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	快照组的UUID		3.6.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.6.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.6.0
timeout		是

回滚最新创建的快照(UndoSnapshotCreation)

用户可以使用UndoSnapshotCreation回滚最新创建的快照。例如：

UndoSnapshotCreation uuid=7fc32ad187c939d8aca65977560c2714 snapShotUuid=7677380457d136629f44c93c99978acc

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	云盘的UUID，唯一标示该资源		5.1.8
snapShotUuid			5.1.8
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	5.1.8
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	5.1.8
timeout		是

解绑快照组(UngroupVolumeSnapshotGroup)

用户可以使用UngroupVolumeSnapshotGroup解绑快照组。例如：

UngroupVolumeSnapshotGroup uuid=8903cef5a11c3457881bfd7bd5f04757

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	快照组的UUID		3.6.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.6.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.6.0
timeout		是

获取资源被引用的内存快照组(GetMemorySnapshotGroupReference)

用户可以使用GetMemorySnapshotGroupReference获取资源被引用的内存快照组。例如：

GetMemorySnapshotGroupReference resourceUuid=8903cef5a11c3457881bfd7bd5f04757 resourceType=293e9dd057c831608cf59cd377ba0d03

参数（Parameters）

名字	描述	可选的	起始支持版本
resourceUuid	资源UUID		4.4.24
resourceType	资源类型
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	4.4.24
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	4.4.24
timeout		是

标签（Tags）

用户可以使用resourceType=VolumeSnapshotVO创建快照组用户标签。例如：

CreateUserTag resourceType=VolumeSnapshotVO tag=golden-ResourceStack
resourceUuid=27260a1dfa93453087d67c69dc78805c