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

文档中心

立即注册

导航

CreateAutoSnapshotPolicy

最近更新时间：2024.06.20 19:04:18首次发布时间：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` 天。

返回参数

参数	类型	示例值	描述
AutoSnapshotPolicyId	String	asp-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****"
  }
}