全部產品
Search

搜尋本產品

    File Storage NAS：CreateSnapshot - 建立快照

    文件中心

    File Storage NAS：CreateSnapshot - 建立快照

    更新時間：Apr 04, 2026

    建立一個快照。

    介面說明

    • 該功能免費公測中，公測期間不保障Apsara File Storage NAS 服務等級協議（SLA）。

    • 僅極速型 NAS 進階型支援建立快照。

    • 一個檔案系統最多支援建立 128 份快照。

    • 檔案系統掛載的執行個體必須處於正常狀態，否則無法建立快照。

    • 如果建立快照還未完成，您無法為該檔案系統再次建立快照。

    • 如果建立快照時檔案系統正好達到到期釋放時間，檔案系統會被釋放的同時也會刪除建立中（Creating）的快照。

    • 建立快照可能會輕微降低檔案系統的效能，I/O 效能短暫變慢，建議您避開業務高峰。

    • 快照只會備份某一時刻的資料，建立快照期間，操作檔案系統產生的增量資料不會同步到快照中。

    • 您手動建立的快照會一直保留，直至賬戶欠費停止服務 15 天后被刪除。請定期刪除不再需要的快照，避免快照容量持續計費。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nas:CreateSnapshot

    create

    *Snapshot

    acs:nas:{#regionId}:{#accountId}:snapshot/*

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    FileSystemId

    string

    是

    極速型 NAS 進階型檔案系統 ID。必須以extreme-開頭，例如extreme-01dd****

    extreme-01dd****
    SnapshotName

    string

    否

    快照名稱。

    限制：

    • 長度為 2~128 個英文或中文字元。必須以大小寫字母或中文開頭，不能以http://和https://開頭。

    • 可以包含數字、半形冒號（:）、底線（_）或者短劃線（-）。

    • 為防止和自動快照的名稱衝突，不能以 auto 開頭。

    FinanceJoshua
    Description

    string

    否

    快照說明。

    限制：

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

    • 不能以http://和https://開頭。

    • 預設為空白。

    FinanceDepet
    RetentionDays

    integer

    否

    快照的保留時間。

    單位：天

    取值：

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

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

    30

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    SnapshotId

    string

    快照 ID。

    s-extreme-snapsho****
    RequestId

    string

    請求 ID。

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

    樣本

    正常返回樣本

    JSON格式

    {
  "SnapshotId": "s-extreme-snapsho****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    錯誤碼

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

    變更歷史

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