全部產品
Search
文件中心

File Storage NAS:UpdateLifecyclePolicy - 更新生命週期管理原則的規則

更新時間:Apr 04, 2026

更新一個生命週期管理原則的規則。僅智算 CPFS 支援。 UpdateLifecyclePolicy 是覆蓋語義,非必選參數為空白則表示刪除對應欄位。當您需要追加生命週期規則時,請先調用 DescribeLifecyclePolicies 介面擷取當前生命週期規則配置,然後追加新的生命週期規則配置,最後調用 UpdateLifecyclePolicy 介面更新生命週期規則配置。

調試

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

調試

授權資訊

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

請求參數

名稱

類型

必填

描述

樣本值

FileSystemId

string

檔案系統 ID。

bmcpfs-290w65p03ok64y*****

StorageType

string

分級儲存類型。

  • InfrequentAccess:低頻儲存(預設值)。

  • Archive:Archive Storage。

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

返回參數

名稱

類型

描述

樣本值

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. 指定的檔案系統不存在。

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

變更歷史

更多資訊,參考變更詳情