调用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 |
自动快照的保留时间。 单位:天 取值:
|
AutoSnapshotPolicyName | String | 否 | FinanceJoshua |
自动快照策略的名称。 限制:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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****"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交