全部產品
Search

搜尋本產品

    File Storage NAS：UpdateLifecyclePolicy

    文件中心

    File Storage NAS：UpdateLifecyclePolicy

    更新時間：Sep 10, 2026

    更新一個生命週期管理策略的規則。僅智算 CPFS 支援。 UpdateLifecyclePolicy 是覆蓋語意，非必選參數為空則表示刪除對應欄位。當您需要追加生命週期規則時，請先呼叫 DescribeLifecyclePolicies 介面取得目前生命週期規則設定，然後追加新的生命週期規則設定，最後呼叫 UpdateLifecyclePolicy 介面更新生命週期規則設定。

    調試

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

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    FileSystemId

    string

    是

    檔案系統 ID。以 bmcpfs- 開頭，如 bmcpfs-290w65p03ok64ya****。

    說明

    僅 CPFS 智算版檔案系統的生命週期管理策略中 LifecyclePolicyType 為 OnDemand 時支援。

    bmcpfs-290w65p03ok64y*****
    StorageType

    string

    否

    分級儲存類型。

    • InfrequentAccess：低頻儲存（預設值）。

    • Archive：歸檔儲存。

    枚舉值：

    • Archive :

      歸檔儲存。

    • InfrequentAccess :

      低頻儲存。

    InfrequentAccess
    LifecyclePolicyId

    string

    是

    生命週期策略的 ID。

    說明

    CPFS 智算版檔案系統必填。

    lsp-bp1234567890ab****
    Description

    string

    否

    生命週期策略描述。

    格式： 長度為 3-64 個字元，必須以字母開頭，可以包含英文字母、數字、底線（_）或者短橫線（-）。

    說明

    僅 CPFS 智算版支援。

    Lifecycle policy description
    Paths

    array

    否

    生命週期管理策略關聯目錄的絕對路徑。

    string

    否

    生命週期管理策略關聯目錄的絕對路徑。

    支援關聯多個目錄。必須以正斜線（/）開頭，並且是掛載點中真實存在的路徑，N 的取值範圍為 1~10。

    /path1
    TransitRules

    array<object>

    否

    檔案資料轉儲規則，最多設定 1 個。

    說明

    僅 CPFS 智算版檔案系統的 LifecyclePolicyType=Auto 時支援。

    object

    否

    檔案資料轉儲規則。

    Attribute

    string

    否

    規則的屬性。

    取值：

    • Atime：檔案的存取時間。

    Atime
    Threshold

    string

    否

    規則的閾值。

    取值：

    • 當 Attribute 為 Atime 時，表示多少天未存取的檔案，取值範圍 [1,365]。

    3
    RetrieveRules

    array<object>

    否

    檔案資料取回規則，最多設定 1 個。

    說明

    僅 CPFS 智算版檔案系統支援。

    object

    否

    檔案資料取回規則。

    Attribute

    string

    否

    規則的屬性。取值：

    • RetrieveType：取回方式。

    RetrieveType
    Threshold

    string

    否

    規則的閾值。取值：

    • RetrieveType：

      • AfterVisit：LifecyclePolicyType=Auto 支援，代表盡力 recall on visit。

      • All：LifecyclePolicyType=OnDemand 支援，代表取回所有。

    枚舉值：

    • All :

      All

    • AfterVisit :

      AfterVisit

    All
    DeleteRules

    array<object>

    否

    檔案資料過期刪除規則。

    object

    否

    檔案資料過期刪除規則。

    Attribute

    string

    否

    規則的屬性。

    取值：

    • Atime：檔案的存取時間。

    枚舉值：

    • Atime :

      檔案的存取時間。

    Atime
    Threshold

    string

    否

    規則的閾值。

    取值：

    • 當 Attribute 為 Atime 時，表示多少天未存取的檔案，取值範圍 [1,365]。

    4

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    98696EF0-1607-4E9D-B01D-F20930B6****
    Success

    boolean

    請求狀態。

    包括：

    • true：請求成功。

    • false：請求失敗。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "Success": true
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidLifecyclePolicy.NotFound The specified LifecyclePolicy does not exist. 指定的生命週期策略不存在。
    404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的檔案系統不存在。

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

    變更歷史

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