调用CreateAutoSnapshotPolicy在指定地域下创建一条自动快照策略。自动快照策略可以周期性地为云盘创建快照备份数据,同时适用于系统盘和数据盘。

接口说明

调用该接口创建自动快照策略时,您可以设置自动快照的重复周期、保留时间以及跨地域备份等策略。满足您多样化的数据备份要求。创建自动快照策略后,需要调用ApplyAutoSnapshotPolicy将策略应用到目标云盘。如果您需要调整自动快照策略的内容,请调用ModifyAutoSnapshotPolicyEx

调用该接口时,您需要注意:

  • 一个阿里云账户在一个地域最多能创建100条自动快照策略。
  • 如果云盘数据较多,单次创建自动快照的时长超过两个时间点之间的间隔,则自动跳过下一时间点。示例:您设置了09:00、10:00、11:00和12:00为自动快照时间点。由于云盘数据较多,09:00开始创建快照,10:20完成创建快照,实际耗时80分钟。系统会跳过时间点10:00,等到11:00继续为您创建自动快照。
  • 跨地域复制快照的注意事项请参见复制快照的背景信息章节。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateAutoSnapshotPolicy

系统规定参数。取值:CreateAutoSnapshotPolicy

regionId String cn-hangzhou

自动快照策略所属的地域。您可以调用DescribeRegions查看最新的阿里云地域列表。

autoSnapshotPolicyName String TestName

自动快照策略的名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以http://或https://开头。可以包含数字、半角冒号(:)、下划线(_)或者短划线(-)。

默认值:空

timePoints String ["0", "1", … "23"]

自动快照的创建时间点。使用UTC +8时间,单位为小时。取值范围:0~23,代表00:00至23:00共24个时间点,例如1表示01:00。格式说明:

  • 传入的参数需要保持JSON数组格式。例如,["1"]表示01:00创建自动快照。
  • 当一天内需要创建多次自动快照时,可以传入多个时间点,时间点之间用半角逗号(,)隔开,最多传入24个时间点。例如,["1","3","5"]表示01:00、03:00、05:00时创建自动快照。
repeatWeekdays String ["1","2"]

自动快照的重复日期,单位为天,周期为星期。取值范围:1~7,例如1表示周一。格式说明:

  • 传入的参数需要保持JSON数组格式。例如,["1"]表示每周一重复创建自动快照。
  • 当一星期内需要创建多次自动快照时,可以传入多个时间点,时间点之间用半角逗号(,)隔开,最多传入7个时间点。例如,["1","3","5"]表示每周一、周三、周五重复创建自动快照。
retentionDays Integer 30

自动快照的保留时间,单位为天。取值范围:

  • -1:永久保存
  • 1~65535:指定保存天数

默认值:-1

EnableCrossRegionCopy Boolean false

是否允许自动跨地域复制。

  • true:允许
  • false:不允许
TargetCopyRegions String ["cn-hangzhou"]

跨地域复制快照的目标地域。目前支持设置一个目标地域。

CopiedSnapshotsRetentionDays Integer 30

跨地域复制快照的保留时间,单位为天。取值范围:

  • -1:永久保存
  • 1~65535:指定保存天数

默认值:-1

ResourceGroupId String rg-aek2kkmhmhs****

资源组ID。

Tag.N.Key String TestKey

快照的标签键。N的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以aliyun或acs:开头,不能包含http://或https://。

Tag.N.Value String TestValue

快照的标签值。N的取值范围:1~20。一旦传入该值,可以为空字符串。最多支持128个字符,不能以acs:开头,不能包含http://或https://。

返回数据

名称 类型 示例值 描述
AutoSnapshotPolicyId String sp-bp12m37ccmxvbmi5****

自动快照策略ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateAutoSnapshotPolicy
&regionId=cn-hangzhou
&repeatWeekdays=["1"]
&retentionDays=30
&timePoints=["0", "19"]
&autoSnapshotPolicyName=TestName
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateAutoSnapshotPolicyRes