UpdateAutoSnapshotPolicy--文件存储 NAS-火山引擎

文档中心

立即注册

导航

UpdateAutoSnapshotPolicy

最近更新时间：2023.10.17 14:47:17首次发布时间：2023.09.20 10:44:04

调用 UpdateAutoSnapshotPolicy 接口修改自动快照策略信息。

注意事项

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

请求参数

参数	类型	是否必选	示例值	描述
AutoSnapshotPolicyId	String	是	asp-15c19547****	需要修改的自动快照策略 ID。
AutoSnapshotPolicyName	String	否	testName	自动快照策略名称，取值说明如下：不能以数字、中划线（-）或 auto 开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度需要在 1~128 个字符内。
RepeatWeekdays	String	否	1,2	自动快照的重复日期，单位为天，周期为星期，取值说明如下：取值范围为 `1~7`，例如 `1` 表示周一。支持设置多个日期，用英文逗号（,）分隔，最多传入 7 个时间点。
TimePoints	String	否	1,2,3	自动快照的创建时间点，取值说明如下：使用 UTC+8 时间，单位为小时。取值范围：`0~23`，表示 00:00 至 23:00 共 24 个时间点，例如 `1` 表示 01:00。支持设置多个时间点，用英文逗号（,）分隔，最多传入 24 个时间点。
RetentionDays	Integer	否	10	自动快照的保存时长，单位为天，取值说明如下： `-1`：永久保存，直至自动快照数量达上限后自动删除。 `1~65536`：指定保存天数。默认值：`30` 天。
Description	String	否	testdescription	自动快照策略描述信息。

返回参数

无。

示例

请求示例

POST /?Action=UpdateAutoSnapshotPolicy&Version=2022-01-01 HTTP/1.1
Host: filenas.volcengineapi.com
Authorization: HMAC-SHA256 Credential=AKLTOGJhY2E1NTdkZGFmNDg0Yjk0ZDFiNjE5Y2NjZjI****/20230907/cn-beijing/filenas/request, SignedHeaders=host;x-date;x-content-sha256;content-type, Signature=7f1119a75111535b1d6e7929700f22e1474af0fb4fe26c59f5ac5cdba0cc****
Content-Type: application/json; charset=utf-8
X-Content-Sha256: 567112abe45bd6a09504fd244237f14c0ba120491da0d35097afd54d87bd****
X-Date: 20230907T124910Z
{
    "AutoSnapshotPolicyId": "asp-15c19547****",
    "RetentionDays": 10,
    "AutoSnapshotPolicyName": "testName",
    "Description": "testdescription",
    "RepeatWeekdays": "1,2",
    "TimePoints": "1,2,3"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202306041104200100100232280022D31",
        "Action": "UpdateAutoSnapshotPolicy",
        "Version": "2022-01-01",
        "Service": "FileNAS",
        "Region": "cn-beijing"
    },
    "Result": {}
}