You need to enable JavaScript to run this app.
导航
文件存储 NAS
  • 文档首页
    • /
  • 文件存储 NAS

CreateAutoSnapshotPolicy

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

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

我的收藏

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

注意事项

  • 目前快照功能处于免费阶段，每个文件存储实例最多可以创建 5 个自动快照；当自动快照数量达到上限后，系统会自动删除创建时间最早的自动快照。
  • 您设置的自动快照策略时间和实际创建快照时间可能存在一定差异，请以实际创建的时间为准。
  • 文件存储实例不能同时创建自动快照和手动快照。在自动快照创建时间点，如果该文件系统正在执行创建快照任务（手动或自动创建快照），则系统不会创建该时间点的自动快照。
    更多注意事项信息，请参见创建自动快照策略。

请求参数

参数类型是否必选示例值描述

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 天。
DescriptionString否policytest自动快照策略描述信息。

返回参数

参数类型示例值描述
AutoSnapshotPolicyIdStringasp-15c19547****自动快照策略 ID。

示例

请求示例

POST /?Action=CreateAutoSnapshotPolicy&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
{
    "AutoSnapshotPolicyName": "testName",
    "RepeatWeekdays": "1,2",
    "TimePoints": "1,2,3",
    "Description": "policytest",
    "RetentionDays": 10
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202306041104200100100232280022D31",
    "Action": "CreateAutoSnapshotPolicy",
    "Version": "2022-01-01",
    "Service": "FileNAS",
    "Region": "cn-beijing"
  },
  "Result": {
    "AutoSnapshotPolicyId": "asp-15c19547****"
  }
}