DescribeLifecyclePolicies - File Storage NAS

取得生命週期管理策略清單。

介面說明

僅通用型 NAS 檔案系統和 CPFS 智算版支援該功能。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

nas:DescribeLifecyclePolicies

get

*LifecyclePolicy

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

無

請求參數

名稱	類型	必填	描述	樣本值
FileSystemId	string	否	檔案系統 ID。	31a8e4****
LifecyclePolicyName	string	否	生命週期策略名稱。命名規則如下：長度為 3-64 個字元，必須以大小寫字母開頭，可以包含英文字母、數字、底線（_）或者短劃線（-）。說明通用型 NAS 檔案系統選填，如果傳入則以此為準，沒有傳入則以 LifecyclePolicyId 為準。	lifecyclepolicy_01
PageSize	integer	否	每個分頁包含的生命週期管理策略個數。取值範圍：1~100 預設值：10	10
PageNumber	integer	否	清單的分頁頁碼。起始值（預設值）：1	1
StorageType	string	否	分級儲存類型。 InfrequentAccess：低頻儲存。 Archive：歸檔儲存。說明如未指定 StorageType，則傳回所有生命週期策略。枚舉值： Archive : 歸檔儲存 InfrequentAccess : 低頻儲存	InfrequentAccess
LifecyclePolicyId	string	否	生命週期策略的 ID。	lc-xxx
LifecyclePolicyType	string	否	策略類型。取值： Auto：自動執行 OnDemand：按需執行說明僅 CPFS 智算版支援。枚舉值： Auto : 自動執行 OnDemand : 按需執行	Auto
Description	string	否	策略的描述。說明僅 CPFS 智算版支援。	描述
Path	string	否	根據路徑篩選。說明僅 CPFS 智算版支援。	/abc/

返回參數

名稱	類型	描述	樣本值
	object
TotalCount	integer	生命週期管理策略總數。	10
RequestId	string	請求 ID。	BC7C825C-5F65-4B56-BEF6-98C56C7C****
PageSize	integer	每個分頁包含的生命週期管理策略個數。	10
PageNumber	integer	清單的分頁頁碼。	1
LifecyclePolicies	array<object>	生命週期管理策略資訊集合。
	array<object>
FileSystemId	string	檔案系統 ID。	31a8e4****
LifecycleRuleName	string	生命週期管理策略關聯的管理規則。包括： DEFAULT_ATIME_14：距今 14 天未存取的檔案 DEFAULT_ATIME_30：距今 30 天未存取的檔案 DEFAULT_ATIME_60：距今 60 天未存取的檔案 DEFAULT_ATIME_90：距今 90 天未存取的檔案	DEFAULT_ATIME_14
CreateTime	string	生命週期管理策略建立的時間。執行 ISO8601 標準表示，傳回格式：`yyyy-MM-ddTHH:mm:ssZ`。	2019-10-30T10:08:08Z
Path	string	生命週期管理策略設定的單一目錄的絕對路徑。	/pathway/to/folder
StorageType	string	分級儲存類型。 InfrequentAccess：低頻儲存。 Archive：歸檔儲存。	InfrequentAccess
LifecyclePolicyName	string	生命週期管理策略名稱。	lifecyclepolicy_01
Paths	array	生命週期管理策略設定的多個目錄的絕對路徑清單。
	string	生命週期管理策略設定的多個目錄的絕對路徑清單。	["/path1","/path2"]
LifecyclePolicyId	string	生命週期策略的 ID	lc-xxx
Description	string	描述	描述
LifecyclePolicyType	string	策略類型	Auto
TransitRules	array<object>	檔案資料轉儲規則
	object	檔案資料轉儲規則
Attribute	string	轉儲規則的屬性	Atime
Threshold	string	轉儲規則的閾值	3
RetrieveRules	array<object>	檔案資料取回規則
	object	檔案資料取回規則
Attribute	string	取回規則的屬性	RetrieveType
Threshold	string	取回規則的閾值	All

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 10,
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "PageSize": 10,
  "PageNumber": 1,
  "LifecyclePolicies": [
    {
      "FileSystemId": "31a8e4****",
      "LifecycleRuleName": "DEFAULT_ATIME_14",
      "CreateTime": "2019-10-30T10:08:08Z",
      "Path": "/pathway/to/folder",
      "StorageType": "InfrequentAccess",
      "LifecyclePolicyName": "lifecyclepolicy_01",
      "Paths": [
        "[\"/path1\",\"/path2\"]"
      ],
      "LifecyclePolicyId": "lc-xxx",
      "Description": "描述",
      "LifecyclePolicyType": "Auto",
      "TransitRules": [
        {
          "Attribute": "Atime",
          "Threshold": "3"
        }
      ],
      "RetrieveRules": [
        {
          "Attribute": "RetrieveType",
          "Threshold": "All"
        }
      ]
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
404	InvalidFileSystem.NotFound	The specified file system does not exist.

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

變更歷史

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