文档中心 云硬盘 API 文档 云硬盘 API 2017 云硬盘快照接口使用示例

云硬盘快照接口使用示例

最近更新时间:2019-07-31 18:47:27

云硬盘快照是对对应云硬盘的完整备份,通过快照,您可以快速的将您的云硬盘恢复到制作快照的时刻,具体请参考 腾讯云快照 文档。为了帮助您快速使用快照 API,这里给出一个使用示例。

该示例首先对指定的云硬盘创建了一个快照,然后使用该快照对云硬盘进行了回滚操作。

创建云硬盘快照

首先使用 CreateSnapshot(创建快照)接口对指定云硬盘创建一个快照。这里对云硬盘ID为disk-nmnaafrh的云硬盘创建了一个名为sanp_test的快照,具体的接口请求参数见下表:

参数名称 描述 取值
storageId 创建快照的云硬盘 ID disk-nmnaafrh
snapshotName 创建出来的快照的名称 snap_test

结合 公共请求参数 和接口请求参数,最终得到的请求形式如下:

https://snapshot.api.qcloud.com/v2/index.php?
Action=CreateSnapshot
&snapshotName=snapshot_test
&storageId=disk-nmnaafrh
&Region=sh
&Nonce=550701091
&Signature=ZMy0vTI%2BIZi1Q3wyQexd3K5iGkA%3D
&SecretId=AKIDxxxxugEY
&Timestamp=1466076669

上述请求返回的结果如下,由结果可知 ,创建的快照ID为snap-amozk0kw。之后,可以通过 DescribeSnapshots(查询快照列表)接口查询快照的创建进度。

{
    "code": 0,
    "message": "",
    "snapshotId": "snap-amozk0kw"
}

回滚快照

您可以通过 ApplySnapshot(回滚快照)接口对快照进行回滚操作。这里将之前创建的快照回滚至原来的云硬盘上,具体的接口请求参数见下表:

参数名称 描述 取值
snapshotId 要回滚的快照 ID snap-amozk0kw
storageId 要回滚至的云硬盘 ID disk-nmnaafrh

结合 公共请求参数 和接口请求参数,最终得到的请求形式如下:

https://snapshot.api.qcloud.com/v2/index.php?
Action=ApplySnapshot
&snapshotId=snap-amozk0kw
&storageId=disk-nmnaafrh
&Region=sh
&Timestamp=1466078504
&Nonce=1519922454
&SecretId=AKIDxxxxugEY
&Signature=e8NZOcYCZJniAAMgVYhqsO70wd0%3D

上述请求返回的结果如下:

{
    "code": 0,
    "message": ""
}