全部產品
Search

搜尋本產品

    File Storage NAS：CreateAutoSnapshotPolicy

    文件中心

    File Storage NAS：CreateAutoSnapshotPolicy

    更新時間：Jun 25, 2026

    建立一條自動快照策略。

    介面說明

    • 該功能免費公測中，公測期間不保障檔案儲存 NAS 服務等級協議（SLA）。

    • 僅極速型 NAS 進階型支援該功能。

    • 一個阿里雲帳號在一個地域最多能建立 100 條自動快照策略。

    • 如果檔案系統資料較多，單次建立自動快照的時長超過兩個時間點間隔，則自動跳過下一時間點。例如：您設定了 09:00、10:00、11:00 和 12:00 為自動快照時間點。由於檔案系統資料較多，09:00 開始建立快照，10:20 完成建立快照，實際耗時 80 分鐘。系統會跳過 10:00 時間點，待 11:00 繼續為您建立自動快照。

    • 每個檔案系統最多支援建立自動快照 128 個，達到快照額度上限後，系統會自動刪除最早建立的自動快照，手動快照不受影響。

    • 修改自動快照策略的保留時間時，僅對新增快照生效，存量快照沿用歷史保留時間。

    • 正在對某一個檔案系統執行自動快照時，您需要等待自動快照完成後，才能手動建立快照。

    • 非正常狀態的檔案系統無法執行自動快照策略。

    • 建立的自動快照具有統一命名格式：auto_yyyyMMdd_X。其中，auto：表示自動快照，與手動快照區分；yyyyMMdd：表示建立快照的日期，y 表示年、M 表示月、d 表示天；X：當日建立的第幾份自動快照。例如：auto_20201018_1表示 2020 年 10 月 18 日建立的第一份自動快照。

    • 已建立的自動快照策略可以應用於任一檔案系統 ApplyAutoSnapshotPolicy，且支援修改策略內容 ModifyAutoSnapshotPolicy。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nas:CreateAutoSnapshotPolicy

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RepeatWeekdays

    string

    是

    自動快照的重複日期。

    週期：星期

    取值：1~7，依次表示週一至週日。

    如果一星期內需要建立多次自動快照時，可設定多個時間點，多個時間點用半形逗號（,）隔開，最多設定 7 個時間點。

    1,2,3
    TimePoints

    string

    是

    自動快照的建立時間點。

    單位：小時

    取值：0~23，代表 00:00 至 23:00 共 24 個時間點，例如：1 表示 01:00。

    當一天內需要建立多次自動快照時，可以設定多個時間點，多個時間點用半形逗號（,）隔開，最多支援設定 24 個時間點。

    0,1,…,23
    RetentionDays

    integer

    否

    自動快照的保留時間。

    單位：天

    取值：

    • -1（預設值）：永久儲存，當快照數量達到額度上限後被自動刪除。

    • 1~65536：指定儲存天數，保留時間到期後快照會被自動釋放。

    30
    AutoSnapshotPolicyName

    string

    否

    自動快照策略的名稱。

    限制：

    • 長度為 2~128 個英文或中文字元。

    • 必須以大小寫字母或中文開頭。

    • 可包含數字、半形冒號（:）、底線（_）或短橫線（-），不能以http://和https://開頭。

    • 預設為空。

    FinanceJoshua
    FileSystemType

    string

    是

    檔案系統類型。

    取值：extreme（極速型 NAS）

    枚舉值：

    • extreme :

      極速型 NAS

    extreme

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    AutoSnapshotPolicyId

    string

    自動快照策略 ID。

    sp-extreme-233e6****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "AutoSnapshotPolicyId": "sp-extreme-233e6****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。