全部產品
Search

搜尋本產品

    File Storage NAS：CreateLifecyclePolicy - 建立生命週期管理原則

    文件中心

    File Storage NAS：CreateLifecyclePolicy - 建立生命週期管理原則

    更新時間：Apr 04, 2026

    建立一個生命週期管理原則。

    介面說明

    • 僅通用型 NAS 檔案系統和 CPFS 智算版支援建立生命週期管理原則。

    • 每個 CPFS 智算版檔案系統最多建立 10 個 Auto 類型 和 100 個 OnDemand 類型的生命週期管理原則。

    • 每個地區可以建立 20 個通用型 NAS 的生命週期管理原則。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nas:CreateLifecyclePolicy

    create

    *LifecyclePolicy

    acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    FileSystemId

    string

    是

    檔案系統 ID。

    31a8e4****
    LifecyclePolicyName

    string

    否

    生命週期管理原則名稱。 長度為 3~64 個字元，必須以大寫字母或小寫字母開頭，可以包含英文字母、數字、底線（_）或者短劃線（-）。

    說明

    通用型 NAS 必須傳入，CPFS 智算版無需填入。

    lifecyclepolicy_01
    Path

    string

    否

    生命週期管理原則關聯目錄的絕對路徑。僅支援通用型 NAS。

    • 通用型 NAS 僅支援關聯單個目錄。必須以正斜線（/）開頭，並且是掛載點中真實存在的路徑。

    說明

    僅支援通用型 NAS。通用型 NAS 建議您配置 Paths.N，可以同時關聯多個目錄。

    • Path 和 Paths 有且只能存在一個入參。

    /pathway/to/folder
    LifecycleRuleName

    string

    否

    生命週期管理原則關聯的管理規則。僅通用型 NAS 支援。

    取值：

    • DEFAULT_ATIME_14：距今 14 天未訪問的檔案。

    • DEFAULT_ATIME_30：距今 30 天未訪問的檔案。

    • DEFAULT_ATIME_60：距今 60 天未訪問的檔案 。

    • DEFAULT_ATIME_90：距今 90 天未訪問的檔案。

    • DEFAULT_ATIME_180：距今 180 天未訪問的檔案。僅當 StorageType=Archive 時，支援 DEFAULT_ATIME_180。

    說明

    • 如果該目錄已經設定了低頻策略，再次設定歸檔策略的時候，歸檔策略的時間要比低頻原則設定的長。

    • 僅通用型 NAS 支援該參數。

    DEFAULT_ATIME_14
    StorageType

    string

    是

    分級儲存類型。

    • InfrequentAccess：低頻儲存。

    • Archive：Archive Storage。

    說明

    通用型 NAS 支援 InfrequentAccess 和 Archive； CPFS 智算版僅支援 InfrequentAccess。

    InfrequentAccess
    Paths

    array

    否

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

    "/path1", "/path2"

    string

    否

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

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

    說明

    • Path 和 Paths 有且只能存在一個入參。

    “/path1"
    Description

    string

    否

    生命週期策略描述。

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

    說明

    僅 CPFS 智算版支援。

    描述
    LifecyclePolicyType

    string

    否

    策略類型

    • Auto（預設）：自動執行。

    • OnDemand：按需執行。

    Auto
    TransitRules

    array<object>

    否

    檔案資料轉儲規則，最多配置 1 個。

    說明

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

    object

    否

    檔案資料轉儲規則，最多配置 1 個。

    說明

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

    Attribute

    string

    否

    規則的屬性。

    取值：

    • Atime: 檔案的訪問時間。

    Atime
    Threshold

    string

    否

    規則的閾值。

    取值：

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

    3
    RetrieveRules

    array<object>

    否

    檔案資料取回規則，最多配置 1 個。

    說明

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

    object

    否

    檔案資料取回規則，最多配置 1 個。

    Attribute

    string

    否

    規則的屬性，取值：

    • RetrieveType: 取回方式

    RetrieveType
    Threshold

    string

    否

    規則的閾值，取值：

    • RetrieveType

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

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

    All

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    BC7C825C-5F65-4B56-BEF6-98C56C7C****
    Success

    boolean

    請求狀態。

    包括：

    • true：請求成功。

    • false：請求失敗。

    true
    LifecyclePolicyId

    string

    生命週期策略的 ID

    lsp-bp1234567890ab****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "Success": true,
  "LifecyclePolicyId": "lsp-bp1234567890ab****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 OperationDenied.FileSystemNotSupportedForLifecycle The file system does not support lifecycle. 指定的檔案系統不支援生命週期管理。
    400 OperationDenied.EncryptedFileSystemNotSupportedForLifecycle The encrypted file system does not support lifecycle. 加密的檔案系統不支援生命週期管理。
    400 OperationDenied.LifecyclePolicyCountLimitExceeded The maximum number of LifecyclePolicies is exceeded. 生命週期策略數量達到上限。
    400 InvalidLifecyclePolicy.AlreadyExist The specified LifecyclePolicy already exists. 指定的生命週期策略已存在。
    400 InvalidParameter.PathsNumberExceed The maximum number of Path.N for this operation is 10. 每個策略最多允許關聯10個路徑。
    400 InvalidFilesystemType.NotSupport The API operation does not support the file system type. 當前介面不支援該類型檔案系統。
    400 InvalidParameter.PathOrPaths Either Path or Paths.N must be specified. Path 和 Paths.N參數必須指定其中一個，並且不能同時指定。
    400 MissingFileSystemId FileSystemId is mandatory for this action. 未指定FileSystemId參數。
    400 Lifecycle.Count.Exceeded The lifecycle policy count exceeds the max limit per type per filesystem. 生命週期策略超過限制。
    403 OperationDenied.NotSupportPaths.N Your request does not meet the gray condition. The Paths.N parameter is not supported. 當前請求未通過灰階策略，不持支Paths.N參數。
    404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的檔案系統不存在。
    404 InvalidParameter.PathNotExist The specified path does not exist. 指定的路徑不存在。

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

    變更歷史

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