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

注意事项

目前快照功能处于免费阶段，每个文件系统最多可以创建 5 个自动快照；当自动快照数量达到上限后，系统会自动删除创建时间最早的自动快照。

您设置的自动快照策略时间和实际创建快照时间可能存在一定差异，请以实际创建的时间为准。

文件系统不能同时创建自动快照和手动快照。在自动快照创建时间点，如果该文件系统正在执行创建快照任务（手动或自动创建快照），则系统不会创建该时间点的自动快照。

更多注意事项信息，请参见创建自动快照策略。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：CreateAutoSnapshotPolicy

要执行的操作，取值：CreateAutoSnapshotPolicy。

Version string 必选示例值：2022-01-01

API的版本，取值：2022-01-01。

AutoSnapshotPolicyName string 必选示例值：test

自动快照策略名称，取值说明如下：

不能以数字、中划线（-）或 auto 开头。

只能包含中文、字母、数字、下划线（_）或中划线（-）。

长度需要在 1~128 个字符内。

RepeatWeekdays string 必选示例值：3

自动快照的重复日期，单位为天，周期为星期，取值说明如下：

取值范围为 1~7，例如 1 表示周一。

支持设置多个日期，用英文逗号（,）分隔，最多传入 7 个时间点。

TimePoints string 必选示例值：15,18,21

自动快照的创建时间点，取值说明如下：

使用 UTC+8 时间，单位为小时。

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

支持设置多个时间点，用英文逗号（,）分隔，最多传入 24 个时间点。

RetentionDays string 可选示例值：1

自动快照的保存时长，单位为天，取值说明如下：

-1：永久保存，直至自动快照数量超出上限后自动删除。

1~65536：指定保存天数。

默认值：30 天。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

AutoSnapshotPolicyId string 示例值：asp-******

自动快照策略 ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter.Description	The specified parameter Description is invalid.	指定的描述信息不合法。
400	InvalidParameter_RepeatWeekdays	The specified parameter AutoSnapshotPolicy RepeatWeekdays is invalid.	自动生成快照策略参数 RepeatWeekdays 不合法。
400	InvalidParameter_TimePoints	The specified parameter AutoSnapshotPolicy TimePoints is invalid.	自动生成快照策略参数 TimePoints 不合法。
400	InvalidParameter_RetentionDays	The specified parameter AutoSnapshotPolicy RetentionDays is invalid, must in 1~65536.	自动生成快照策略参数 RetentionDays 不合法。
400	InvalidParameter_AutoSnapshotPolicyName	The specified parameter AutoSnapshotPolicy AutoSnapshotPolicyName is invalid	自动生成快照策略参数 AutoSnapshotPolicyName 不合法。
400	InvalidParameter	The specified parameter format is invalid.	指定的参数格式无效。
400	InvalidParameter.AutoSnapshotPolicyName	The specified parameter AutoSnapshotPolicyName is invalid.	指定的参数 AutoSnapshotPolicyName 无效。
400	InvalidParameter.RepeatWeekdays	The specified parameter AutoSnapshotPolicy RepeatWeekdays is invalid.	指定的参数 AutoSnapshotPolicy RepeatWeekdays 无效。
400	InvalidParameter.RetentionDays	The specified parameter AutoSnapshotPolicy RetentionDays is invalid, must in 1~65536.	指定的参数 AutoSnapshotPolicy RetentionDays 无效，必须在 1~65536 之间。
400	InvalidParameter.TimePoints	The specified parameter AutoSnapshotPolicy TimePoints is invalid.	指定的参数 AutoSnapshotPolicy TimePoints 无效。
500	InternalError	An internal error has occurred.	内部错误。

弹性文件存储