调用CreateAutoSnapshotPolicy接口创建一条自动快照策略。

接口说明

  • 一个阿里云账号在一个地域最多能创建100条自动快照策略。
  • 如果文件系统数据较多，单次创建自动快照的时长超过两个时间点间隔，则自动跳过下一时间点。例如：您设置了09:00、10:00、11:00 和12:00为自动快照时间点。由于文件系统数据较多，09:00开始创建快照，10:20完成创建快照，实际耗时80分钟。系统会跳过10:00时间点，待11:00继续为您创建自动快照。
  • 每个文件系统最多支持创建自动快照128个，达到快照额度上限后，系统会自动删除最早创建的自动快照，手动快照不受影响。
  • 修改自动快照策略的保留时间时，仅对新增快照生效，存量快照沿用历史保留时间。
  • 正在对某一个文件系统执行自动快照时，您需要等待自动快照完成后，才能手动创建快照。
  • 非正常状态的文件系统无法执行自动快照策略。
  • 创建的自动快照具有统一命名格式：auto_yyyyMMdd_X。其中，auto：表示自动快照，与手动快照区分；yyyyMMdd：表示创建快照的日期，y 表示年、M 表示月、d 表示天；X：当日创建的第几份自动快照。例如：auto_20201018_1表示2020年10月18日创建的第一份自动快照。
  • 已创建的自动快照策略可以应用于任一文件系统ApplyAutoSnapshotPolicy，且支持修改策略内容ModifyAutoSnapshotPolicis。

调试

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

请求参数

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

接口名称。

固定取值：CreateAutoSnapshotPolicy
FileSystemType String 是 extreme

文件系统类型。

取值：extreme（极速型NAS）
RepeatWeekdays String 是 1,2,3

自动快照的重复日期。

周期：星期

取值：1~7，依次表示周一至周日。

如果一星期内需要创建多次自动快照时，可设置多个时间点，多个时间点用半角逗号（,）隔开，最多设置7个时间点。
TimePoints String 是 0,1,…23

自动快照的创建时间点。

单位：小时

取值：0~23，代表00:00至23:00共24个时间点，例如：1表示01:00。

当一天内需要创建多次自动快照时，可以设置多个时间点，多个时间点用半角逗号（,）隔开，最多支持设置24个时间点。
RetentionDays Integer 否 30

自动快照的保留时间。

单位：天

取值：

  • -1（默认值）：永久保存，当快照数量达到额度上限后被自动删除。
  • 1~65536：指定保存天数，保留时间到期后快照会被自动释放。
AutoSnapshotPolicyName String 否 FinanceJoshua

自动快照策略的名称。

限制：

  • 长度为2~128个英文或中文字符。
  • 必须以大小字母或中文开头。
  • 可包含数字、半角冒号（:）、下划线（_）或短划线（-），不能以http://和https://开头。
  • 默认为空。

返回数据

名称 类型 示例值 描述
AutoSnapshotPolicyId String sp-extreme-233e6****

自动快照策略ID。
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateAutoSnapshotPolicy
&FileSystemType=extreme
&RepeatWeekdays=1,2,3
&TimePoints=0,1,…23
&<公共请求参数>

正常返回示例

XML格式 

<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<AutoSnapshotPolicyId>sp-extreme-233e6****</AutoSnapshotPolicyId>

JSON格式 

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
    "AutoSnapshotPolicyId": "sp-extreme-233e6****"
}

错误码

访问错误中心查看更多错误码。