文档中心

弹性文件存储

自动快照策略

UpdateAutoSnapshotPolicy - 更新自动快照策略

UpdateAutoSnapshotPolicy - 更新自动快照策略

调用 UpdateAutoSnapshotPolicy 接口更新自动快照策略。

注意事项

修改自动快照策略后，之前已应用该策略的云盘会自动执行修改后的自动快照策略。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：UpdateAutoSnapshotPolicy

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

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

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

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

目标自动快照策略 ID。

AutoSnapshotPolicyName string 可选示例值：test

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

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

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

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

RepeatWeekdays string 可选示例值：3

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

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

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

RetentionDays string 可选示例值：1

自动快照的保留时间。单位为天，取值说明如下：

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

1~65536：指定保存天数。

默认值：30 天。

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

自动快照的创建时间点。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	InvalidParameter_RepeatWeekdays	The specified parameter AutoSnapshotPolicy RepeatWeekdays is invalid.	自动生成快照策略参数 RepeatWeekdays 不合法。
400	MissingParameter_AutoSnapshotPolicyId	The required parameter AutoSnapshotPolicyId is not supplied.	参数 AutoSnapshotPolicyId 不能为空
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.AutoSnapshotPolicyName	The specified parameter AutoSnapshotPolicyName is invalid.	指定的参数 AutoSnapshotPolicyName 不合法。
500	InternalError	An internal error has occurred.	内部错误。

最近更新时间：2025.11.24 16:33:12

这个页面对您有帮助吗？

有用

有用

无用

无用