创建一条自动快照策略。
接口说明
- 该功能免费公测中，公测期间不保障文件存储 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代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| 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 |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"AutoSnapshotPolicyId": "sp-extreme-233e6****"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-09-05 | API 内部配置变更，不影响调用 | 查看变更详情 |