阿里云如何使用快照相关接口

 
阿里云如何使用快照相关接口
2016-09-15 07:05:51 /故事大全

创建快照

描述

对指定的磁盘存储设备创建快照。

云服务器仅在 Stopped 或 Running 状态下才能创建快照。(但刚创建完成从未启动过的实例不能创建快照)

刚创建完成的云服务器系统盘,或刚增加从快照创建的数据盘,由于尚未完成数据的加载,此时创建快照会返回错误。一般来说,系统盘创建完成 1 个小时后即可创建快照,数据盘的可创建快照的时间取决于磁盘数据的大小。

新增加一块磁盘后,如果实例尚未启动过,新增的这块磁盘不能用于创建快照。

如果快照创建没有完成(即进度没有达到 100%),那么这个快照无法用于创建自定义镜像。

如果快照创建没有完成(即进度没有达到 100%),那么不能对同一磁盘再次创建快照。

快照数量的配额取决于该帐号下拥有的磁盘总数量。最多可创建的快照数量为磁盘数量乘以 6 + 6。

如果磁盘在 In_use 状态下,挂载的实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时,不能创建快照。

磁盘挂载的实例创建后第一次启动前,不能创建快照

独立普通云盘创建后,如果没有挂载过,创建快照会出现错误提示。

请求参数

名称 类型 是否必须 描述 Action String 是 系统规定参数,取值:CreateSnapshot DiskId String 是 指定的磁盘 ID SnapshotName String 否 快照的显示名称,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”_”或”-”,且不能以 auto 开头(auto 开头的快照名是预留给自动快照的)。快照的显示名称会显示在控制台中。不能以 // 和 https:// 开头。 Description String 否 快照的描述,[2, 256] 个字符。快照的描述会显示在控制台中。不填则为空,默认为空。不能以 // 和 https:// 开头。 ClientToken String 否 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。

具体参见附录:如何保证幂等性。

返回参数

名称 类型 描述 SnapshotId String 快照 ID

错误码

错误代码 描述 Http 状态码 语义 MissingParameter The input parameter "DiskId" that is mandatory for processing this request is not supplied. 400 DiskId 参数未指定 InvalidDiskId.NotFound The specified DiskId does not exist. 404 指定的磁盘不存在 InvalidSnapshotName.Malformed The specified SnapshotName is wrongly formed. 400 SnapshotName 格式不合法 InvalidDescription.Malformed The specified description is wrongly formed. 404 Description 格式不合法 IncorrectInstanceStatus The current status of the resource does not support this operation. 400 指定的实例状态不正确 IncorrectDiskStatus.CreatingSnapshot The snapshot of the disk is still creating. 403 指定的磁盘正在创建快照 InstanceLockedForSecurity The disk attached instance is locked due to security. 403 指定的实例被安全锁定 IncorrectDiskStatus.NeverAttached The specified disk has never been attached to any instance. 403 可卸载的普通云盘创建后未被挂载,内容没有变化 QuotaExceed.Snapshot The snapshot quota exceeds. 403 快照额度超过限制 IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating. 403 磁盘创建后未被使用,内容没有变化 CreateSnapshot.Failed The process of creating snapshot is failed 403 创建快照失败

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateSnapshot

&DiskId=1033-60053321

&<公共请求参数>

返回示例

XML格式

C8B26B44-0189-443E-9816-D951F59623A9

s-923FE2BF0

JSON格式

{

"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",

"SnapshotId": "s-923FE2BF0"

}

所属专题:
如果您觉得本文或图片不错,请把它分享给您的朋友吧!

 
故事大全
 
版权所有- © 2012-2015 · 故事大全 SITEMAP站点地图手机看故事 站点地图