You need to enable JavaScript to run this app.
导航

UpdateAutoSnapshotPolicy

最近更新时间2023.10.17 14:47:17

首次发布时间2023.09.20 10:44:04

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

注意事项

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

请求参数

参数类型是否必选示例值描述
AutoSnapshotPolicyIdStringasp-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 天。
DescriptionStringtestdescription自动快照策略描述信息。

返回参数

无。

示例

请求示例

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": {}
}