DescribeLifecyclePolicyLogs - File Storage NAS

查詢生命週期策略的執行日誌。可查詢最近 90 天或最多 1000 筆日誌。僅 CPFS 智算版支援。

介面說明

查詢生命週期策略的執行日誌。可查詢最近 90 天或最多 1000 筆日誌。僅 CPFS 智算版支援。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

nas:DescribeLifecyclePolicyLogs

get

*LifecyclePolicy

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

無

請求參數

名稱	類型	必填	描述	樣本值
FileSystemId	string	是	檔案系統 ID。	bmcpfs-030wldnqm8evtpy****
LifecyclePolicyId	string	是	生命週期策略的 ID。	lc-xxx
PageSize	integer	否	每個分頁包含的日誌筆數。取值範圍：1~100 預設值：10	10
PageNumber	integer	否	清單的分頁頁碼。起始值（預設值）：1	1

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	BC7C825C-5F65-4B56-BEF6-98C56C7C****
Success	boolean	請求狀態。包括： true：請求成功 false：請求失敗	true
LifecyclePolicyLogs	array<object>	生命週期策略的執行日誌。
	array<object>
Status	string	資料取回任務的狀態。包括： PENDING：建立中 RUNNING：執行中 STOPPED：已停止 FINISHED：已結束 FAILED：失敗	RUNNING
Paths	array	指定取回任務的執行路徑。
	string	指定取回任務的執行路徑。	/path1
StorageType	string	分級儲存類型。 InfrequentAccess：低頻儲存（預設值）。 Archive：歸檔儲存。	InfrequentAccess
TransitRules	array<object>	檔案資料轉儲規則。
	object	檔案資料轉儲規則。
Attribute	string	規則的屬性。取值： Atime: 檔案的存取時間。	Atime
Threshold	string	規則的閾值。取值：當 Attribute 為 Atime 時，表示多少天未存取的檔案，取值範圍 [1,365]	3
RetrieveRules	array<object>	檔案資料取回規則。
	object	檔案資料取回規則。
Attribute	string	規則的屬性，取值： RetrieveType: 取回方式	RetrieveType
Threshold	string	規則的閾值，取值： RetrieveType AfterVisit：LifecyclePolicyType=Auto 支援，代表盡力 recall on visit All: LifecyclePolicyType=OnDemand 支援，代表取回所有	All
CreateTime	string	任務建立時間。以 ISO 8601 為標準，並使用 UTC+0 時間，返回格式：yyyy-MM-ddTHH:mm:ssZ。	2025-10-20T02:25:07Z
Summary	string	任務總覽。	Total tasks: 100000, success tasks: 100000
DeleteRules	array<object>	檔案資料過期刪除規則，最多設定 1 個。
	object	檔案資料過期刪除規則，最多設定 1 個。
Attribute	string	規則的屬性。取值： Atime: 檔案的存取時間。	Atime
Threshold	string	規則的閾值。取值：當 Attribute 為 Atime 時，表示多少天未存取的檔案，取值範圍 [1,365]。	3
TotalCount	integer	日誌總數。	36
PageNumber	integer	分頁頁碼。	1
PageSize	integer	每個分頁包含的日誌筆數。	10

樣本

正常返回樣本

JSON格式

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "Success": true,
  "LifecyclePolicyLogs": [
    {
      "Status": "RUNNING",
      "Paths": [
        "/path1"
      ],
      "StorageType": "InfrequentAccess",
      "TransitRules": [
        {
          "Attribute": "Atime",
          "Threshold": "3"
        }
      ],
      "RetrieveRules": [
        {
          "Attribute": "RetrieveType",
          "Threshold": "All"
        }
      ],
      "CreateTime": "2025-10-20T02:25:07Z",
      "Summary": "Total tasks: 100000, success tasks: 100000",
      "DeleteRules": [
        {
          "Attribute": "Atime",
          "Threshold": "3"
        }
      ]
    }
  ],
  "TotalCount": 36,
  "PageNumber": 1,
  "PageSize": 10
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidLifecyclePolicy.NotFound	The specified LifecyclePolicy does not exist.	指定的生命週期原則不存在。
404	InvalidFileSystem.NotFound	The specified file system does not exist.	指定的檔案系統不存在。

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

變更歷史

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