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

　　创建快照

　　描述

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

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

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

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

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

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

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

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

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

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

　　请求参数

名称 类型 是否必须 描述 Action String 是 系统规定参数，取值：CreateSnapshot DiskId String 是 指定的磁盘 ID SnapshotName String 否 快照的显示名称，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”，且不能以 auto 开头（auto 开头的快照名是预留给自动快照的）。快照的显示名称会显示在控制台中。不能以 http:// 和 https:// 开头。 Description String 否 快照的描述，[2, 256] 个字符。快照的描述会显示在控制台中。不填则为空，默认为空。不能以 http:// 和 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"

　　}

　　删除快照

　　描述

　　删除指定的快照。如果需要取消创建中的快照(即快照进度尚未达到 100%)，也可以调用该接口将快照删除(即取消快照创建)。

　　如果指定 ID 的快照不存在，请求将被忽略。

　　如果快照已经被用于创建自定义镜像，则这个快照不能被删除。需要先删除相应的自定义镜像，快照才能被删除。

　　请求参数

名称 类型 是否必须 描述 Action String 是 系统规定参数，取值：DeleteSnapshot SnapshotId String 是 快照 ID

　　返回参数

　　全是公共返回参数，详见公共返回参数

　　错误码

错误代码 描述 Http 状态码 语义 SnapshotCreatedImage The snapshot has been used to create user defined image(s). 403 指定快照已经创建了自定义镜像 SnapshotCreatedDisk The snapshot has been used to create disk(s). 403 指定快照已经创建了磁盘 MissingParameter The input parameter "SnapshotId" that is mandatory for processing this request is not supplied. 400 SnapshotId 参数未指定

　　示例

　　请求示例

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

　　&SnapshotId=s-923FE2BF0

　　&<公共请求参数>

　　返回示例

　　XML格式

　　

　　CEF72CEB-54B6-4AE8-B225-F876FF7BA984

　　

　　JSON格式

　　{

　　"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"

　　}

　　查询快照列表

　　描述

　　查询针对云服务器的某个磁盘设备所有的快照列表。

　　InstanceId，DiskId 和 SnapshotIds 不再作为必选参数，而是作为 Filter 进行使用，为逻辑与关系。

　　请求参数

名称 类型 是否必须 描述 Action String 是 系统规定参数，取值：DescribeSnapshots RegionId String 是 磁盘所属于的 Region ID InstanceId String 否 指定的实例 ID DiskId String 否 指定的磁盘设备 ID SnapshotIds String 否 快照标识编码
一个带有格式的 Json Array：[“s-xxxxxxxxx”, ”s-yyyyyyyyy”, … “s-zzzzzzzzz”]，最多 100 个 Id，用半角逗号字符隔开 SnapshotName String 否 快照名称 Status String 否 快照状态，progressing | accomplished | failed | all SnapshotType String 否 快照类型，auto | user | all SourceDiskType String 否 快照源磁盘的磁盘类型，System | Data Usage String 否 有引用关系的资源类型，image | disk | image_disk | none Tag.n.Key String 否 标签 key，n 从 1 开始，最大为 5。
不允许为空字符串。 Tag.n.Value String 否 标签 value，n 从 1 开始，最大为 5。
允许为空字符串。 PageNumber Integer 否 磁盘状态列表的页码，起始值为 1，默认值为 1 PageSize Integer 否 分页查询时设置的每页行数，最大值 100 行，默认为 10

　　返回参数

名称 类型 描述 RegionId String 镜像所属地域 Id TotalCount Integer 快照总个数 PageNumber Integer 快照列表的页码 PageSize Integer 输入时设置的每页行数 Snapshots SnapshotType 快照详情 SnapshotType 组成的集合

　　错误码

错误代码 描述 Http 状态码 语义 MissingParameter The input parameter "RegionId" that is mandatory for processing this request is not supplied. 400 RegionId 参数未指定 InvalidParameter The specified parameter "PageNumber" is not valid. 400 指定的 PageNumber 参数不合法 InvalidParameter The specified parameter "PageSize" is not valid. 400 指定的 PageSize 参数不合法 InvalidSnapshotIds.Malformed The amount of specified specified snapshot Ids exceeds the limit. 403 SnapshotIds 参数格式不正确 InvalidUsage The specified Usage is not valid 404 指定的 Usage 不合法 InvalidSourceDiskType The specified SourceDiskType is not valid 404 指定的 SourceDiskType 不合法 InvalidStatus.NotFound The specified Status is not found 404 指定的 Status 不存在 InvalidSnapshotType.NotFound The specfied SnapshotType is not found 404 指定的 SnapshotType 不存在

　　示例

　　请求示例

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

　　&RegionId=cn-hangzhou

　　&<公共请求参数>

　　返回示例

　　JSON格式

　　{

　　"PageNumber": 1,

　　"PageSize": 2,

　　"RequestId": "659F91C6-1949-43B0-90C4-B6342CA757D5",

　　"Snapshots": {

　　"Snapshot": [

　　{

　　"CreationTime": "2015-07-30T05:00:14Z",

　　"Progress": "100%",

　　"SnapshotId": "s-943ypfgic",

　　"SnapshotName": "auto_20150730_3",

　　"SourceDiskId": "d-944qyqjfa",

　　"SourceDiskSize": 20,

　　"SourceDiskType": "system",

　　"Status": "accomplished",

　　"Usage": "none"

　　},

　　{

　　"CreationTime": "2015-07-30T05:00:14Z",

　　"Progress": "100%",

　　"SnapshotId": "s-94osg320e",

　　"SnapshotName": "auto_20150730_3",

　　"SourceDiskId": "d-94j355jsq",

　　"SourceDiskSize": 20,

　　"SourceDiskType": "system",

　　"Status": "accomplished",

　　"Usage": "none"

　　}

　　]

　　},

　　"TotalCount": 36

　　}

　　创建自动快照策略

　　描述

　　创建一条自动快照策略。

　　创建自动快照策略的额度是三条，即目前最多只能创建三条自动快照策略。

　　创建的自动快照策略可以应用到任意磁盘。

　　已创建的自动快照策略可以进行修改操作。

　　如果磁盘数据量大，一次打快照时长超过两个自动快照时间点间隔，则下一个时间点不打快照自动跳过;比如：用户设置9:00、10:00、 11:00、12:00为自动快照时间点，9:00打快照的时候时长为80分钟，也就是10:20才打完，那10:00预设时间点将不打快照，下个快照时间点为11:00。

　　请求参数

名称 类型 是否必须 描述 Action String 是 系统规定参数，取值：CreateAutoSnapshotPolicy RegionId String 是 RegionId AutoSnapshotPolicyName String 是 自动快照策略的名称。不填则为空，默认值为空， [2,128]英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”，磁盘名称会展示在控制台。不能以http://和https://开头。 TimePoints String 是 指定自动快照的创建时间点。最小单位为小时，从00:00~23:00共24个时间点可选，参数为0~23的数字，如：1代表在01:00时间点。可以选定多个时间点。传递参数为一个带有格式的 Json Array：[“0”, “1”, … “23”]，最多24个时间点，用半角逗号字符隔开。 RepeatWeekdays String 是 指定自动快照的重复日期。选定周一到周日中需要创建快照的日期，参数为1~7的数字，如：1表示周一。允许选择多个日期。传递参数为一个带有格式的 Json Array：[ “1”，“2”…“7”]。 RetentionDays integer 否 指定自动快照的保留时间，单位为天：
-1：永久保存
1~65536：指定保存天数
默认值：-1 ClientToken String 否 用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不值过64个ASCII字符。具体参见附录！

　　返回参数

名称 类型 描述 AutoSnapshotPolicyId String 自动快照策略ID

　　示例

　　请求示例

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

　　&SettingTimePoints=[“0”, “11 ”, “21 ”]&SettingRepeatWeekdays=[“1” ，“2” ，“4” ，“7”] &RetentionDays=30

　　&<公共请求参数>

　　返回示例

　　XML格式

　　

　　F3CD6886-D8D0-4FEE-B93E-1B73239673DE

　　p-233e6ylv0

　　

　　JSON格式

　　{

　　"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"

　　"AutoSnapshotPolicyId":"p-233e6ylv0"

　　}

　　释放自动快照策略

　　描述

　　释放一条自动快照策略。

　　如果当前预释放的自动快照策略已经在磁盘上执行，释放自动快照策略后这些磁盘取消执行该策略。

　　请求参数

名称 类型 是否必须 描述 Action String 是 操作接口名，系统规定参数，取值：DeleteAutoSnapshotPolicy RegionId String 是 要释放的自动快照策略所在的Region Id AutoSnapshotPolicyId String 是 要释放的自动快照策略的Id

　　返回参数

　　全是公共返回参数，详见公共返回参数。

　　示例

　　请求示例

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

　　&AutoSnapshotPolicyId=p-233e6ylv0

　　&<公共请求参数>

　　返回示例

　　XML格式

　　

　　F3CD6886-D8D0-4FEE-B93E-1B73239673DE

　　

　　JSON格式

　　{

　　"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"

　　}

　　修改自动快照策略

　　描述

　　修改一条自动快照策略。

　　修改自动快照策略后，之前已执行该策略的磁盘随即执行修改后的自动快照策略。

　　请求参数

名称 类型 是否必须 描述 Action String 是 操作接口名，系统规定参数，取值：ModifyAutoSnapshotPolicyEx RegionId String 是 要修改的自动快照策略所在的Region AutoSnapshotPolicyId String 是 要修改的自动快照策略ID。 AutoSnapshotPolicyName String 否 自动快照策略的名称。如果参数为空则代表不修改。 TimePoints String 否 指定自动快照的创建时间点。最小单位为小时，从00:00~23:00共24个时间点可选，参数为0~23的数字，如：1代表01:00时间点。可以选定多个时间点。如果参数为空则代表不修改。传递参数为一个带有格式的 Json Array：[“0”, “1”, … “23”]，最多24 个时间点，用半角逗号字符隔开。 RepeatWeekdays String 否 指定自动快照的重复日期。选定周一到周日中需要创建快照的日期，参数为1~7的数字，如：1表示周一。允许选择多个重复日期。如果参数为空则代表不修改。传递参数为一个带有格式的 Json Array：[ “1”，“2”…“7”]。 RetentionDays Integer 否 指定自动快照的保留时间，单位为天 -1：永久保存 1~65536：指定保存天数 如果该参数为空，则代表不修改 ClientToken String 否 用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不值过64个ASCII字符。具体参见附录！

　　返回参数

　　全是公共返回参数，详见公共返回参数。

　　示例

　　请求示例

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

　　&AutoSnapshotPolicyId=p-233e6ylv0&SettingTimePoints=[“0”, “11 ”, “21 ”]&SettingRepeatWeekdays=[“1” ，“2” ，“4” ，“7”] &RetentionDays=30

　　&<公共请求参数>

　　返回示例

　　XML格式

　　

　　F3CD6886-D8D0-4FEE-B93E-1B73239673DE

　　

　　JSON格式

　　{

　　"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"

　　}

　　查询自动快照策略

　　描述

　　查询自动快照策略

　　请求参数

名称 类型 是否必须 描述 Action String 是 系统规定参数，取值：DescribeAutoSnapshotPolicyEx RegionId String 是 要查询的自动快照策略所在的Region AutoSnapshotPolicyId String 否 要查询的自动快照策略ID，参数为空时为返回全部自动快照策略。一个带有格式的Json Array：[“p-xxxxxxxxx”, ”p-yyyyyyyyy”, … “p-zzzzzzzzz”] PageNumber Integer 否 自动快照策略列表的页码，起始值为 1，默认值为 1 PageSize Integer 否 分页查询时设置的每页行数，最大值 50 行，默认为 10

　　返回参数

名称 类型 描述 TotalCount Integer 快照的总个数 PageNumber Integer 快照列表的页码 PageSize Integer 输入时设置的每页行数 AutoSnapshotPolicys AutoSnapshotPolicyType 自动快照策略详情 AutoSnapshotPolicyType 组成的集合。

　　示例

　　请求示例

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

　　&<公共请求参数>

　　返回示例

　　JSON格式

　　{

　　"PageNumber": 1,

　　"PageSize": 2,

　　"RequestId": "659F91C6-1949-43B0-90C4-B6342CA757D5",

　　"AntoSnapshotPolicys": {

　　" AutoSnapshotPolicy": [

　　{

　　"CreationTime": "2014-07-24T13:00:52Z",

　　"AutoSnapshotPolicyId": "p-23f2i9s4t",

　　"SettingTimePoints": "[“0”, “1”]",

　　"SettingRepeatWeekdays": "[“1”, “7”]",

　　"RetentionDays": "30",

　　},

　　{

　　"CreationTime": "2014-04-21T12:08:52Z",

　　"AutoSnapshotPolicyId": "p-a1fd3g5s1",

　　"SettingTimePoints": "[“2”, “9”]",

　　"SettingRepeatWeekdays": "[“3” , “4” , “5” , “7”]",

　　"RetentionDays": "-1",

　　}

　　]

　　},

　　"TotalCount": 2

　　}

　　执行自动快照策略

　　描述

　　为磁盘执行自动快照策略。

　　一个磁盘只能执行一条自动快照策略，已拥有自动快照策略的情况下再进行执行操作视为修改当前执行的自动快照策略。

　　可同时对多个磁盘执行同一条自动快照策略。

　　对多个磁盘执行同一条自动快照策略时，不能保证这些磁盘的快照数据处于同一个时间点，即无法保证他们是并行快照。

　　请求参数

名称 类型 是否必须 描述 Action String 是 操作接口名，系统规定参数，取值：ApplyAutoSnapshotPolicy RegionId String 是 要执行自动快照的Region AutoSnapshotPolicyId String 是 要执行的自动快照策略Id DiskIds String 是 要应用的自动快照策略的磁盘集合。一个带有格式的 Json Array：[“d-xxxxxxxxx”, ”d-yyyyyyyyy”, … “d-zzzzzzzzz”]，最多 X 个 Id，用半角逗号字符隔开。

　　返回参数

　　全是公共返回参数，详见公共返回参数。

　　示例

　　请求示例

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

　　&Snapshots =[“d-233e6ylv0”, “d-23vbpbi03 ”, “d-23vasz3ds ”]

　　&<公共请求参数>

　　返回示例

　　JSON格式

　　{

　　"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"

　　}

　　取消自动快照策略

　　描述

　　为应用了自动快照策略的磁盘取消自动快照策略。

　　请求参数

名称 类型 是否必须 描述 Action String 是 操作接口名，系统规定参数，取值：CancelAutoSnapshotPolicy RegionId String 是 要取消的自动快照策略所在的Region Id DiskIds String 是 要取消自动快照策略的磁盘集合。一个带有格式的 Json Array：[“d-xxxxxxxxx”, ”d-yyyyyyyyy”, … “d-zzzzzzzzz”]，最多 X 个 Id，用半角逗号字符隔开。

　　返回参数

　　全是公共返回参数，详见公共返回参数。

　　示例

　　请求示例

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

　　&AutoSnapshotPolicyId=p-233e6ylv0

　　&<公共请求参数>

　　返回示例

　　JSON格式

　　{

　　"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"

　　}