创建一条自动快照策略。
接口说明
该功能免费公测中,公测期间不保障文件存储 NAS 服务等级协议(SLA)。
仅极速型 NAS 高级型支持该功能。
一个阿里云账号在一个地域最多能创建 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,且支持修改策略内容 ModifyAutoSnapshotPolicy。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
nas:CreateAutoSnapshotPolicy |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RepeatWeekdays |
string |
是 |
自动快照的重复日期。 周期:星期 取值:1~7,依次表示周一至周日。 如果一星期内需要创建多次自动快照时,可设置多个时间点,多个时间点用半角逗号(,)隔开,最多设置 7 个时间点。 |
1,2,3 |
| TimePoints |
string |
是 |
自动快照的创建时间点。 单位:小时 取值:0~23,代表 00:00 至 23:00 共 24 个时间点,例如:1 表示 01:00。 当一天内需要创建多次自动快照时,可以设置多个时间点,多个时间点用半角逗号(,)隔开,最多支持设置 24 个时间点。 |
0,1,…,23 |
| RetentionDays |
integer |
否 |
自动快照的保留时间。 单位:天 取值:
|
30 |
| AutoSnapshotPolicyName |
string |
否 |
自动快照策略的名称。 限制:
|
FinanceJoshua |
| FileSystemType |
string |
是 |
文件系统类型。 取值:extreme(极速型 NAS) 枚举值:
|
extreme |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| AutoSnapshotPolicyId |
string |
自动快照策略 ID。 |
sp-extreme-233e6**** |
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"AutoSnapshotPolicyId": "sp-extreme-233e6****"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。