DescribeLifecyclePolicyLogs - File Storage NAS - Alibaba Cloud Documentation Center

Queries the execution logs of a lifecycle policy, returning up to 1,000 entries from the last 90 days. This feature is only available for CPFS AI Computing Edition.

Operation description

Queries the execution logs of a lifecycle policy. You can query up to 1,000 log entries from the last 90 days. Only CPFS (AI Computing Edition) supports this operation.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	The file system ID.	bmcpfs-030wldnqm8evtpy****
LifecyclePolicyId	string	Yes	The lifecycle policy ID.	lc-xxx
PageSize	integer	No	The number of log entries to return on each page. Value range: 1–100. Default: 10.	10
PageNumber	integer	No	The number of the page to return. Starts from 1. Default: 1.	1

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	BC7C825C-5F65-4B56-BEF6-98C56C7C****
Success	boolean	Specifies whether the request succeeded. Valid values: `true`: The request succeeded. `false`: The request failed.	true
LifecyclePolicyLogs	array<object>	The execution logs of the lifecycle policy.
	array<object>
Status	string	The status of the task. Valid values: `PENDING`: The task is initializing. `RUNNING`: The task is running. `STOPPED`: The task is stopped. `FINISHED`: The task is complete. `FAILED`: The task failed.	RUNNING
Paths	array	The execution paths of the task.
	string	An execution path of the task.	/path1
StorageType	string	The storage tier. Valid values: `InfrequentAccess`: Infrequent Access (default). `Archive`: Archive Storage.	InfrequentAccess
TransitRules	array<object>	The transition rules for file data.
	object	A transition rule for file data.
Attribute	string	The attribute of the rule. Valid value: `Atime`: The last access time of a file.	Atime
Threshold	string	The rule threshold. Valid values: If `Attribute` is set to `Atime`, this parameter specifies the number of days since a file was last accessed. The value must be an integer from 1 to 365.	3
RetrieveRules	array<object>	The retrieval rules for file data.
	object	A retrieval rule for file data.
Attribute	string	The attribute of the rule. Valid value: `RetrieveType`: The retrieval method.	RetrieveType
Threshold	string	The threshold of the rule. Valid values: If `Attribute` is set to `RetrieveType`: `AfterVisit`: Data is retrieved on a best-effort basis when accessed. This value is available only if `LifecyclePolicyType` is set to `Auto`. `All`: All data is retrieved. This value is available only if `LifecyclePolicyType` is set to `OnDemand`.	All
CreateTime	string	The time when the task was created. The time is displayed in UTC and is in the `yyyy-MM-ddTHH:mm:ssZ` format.	2025-10-20T02:25:07Z
Summary	string	The task summary.	Total tasks: 100000, success tasks: 100000
TotalCount	integer	The total number of logs.	36
PageNumber	integer	The page number.	1
PageSize	integer	The number of entries per page.	10

Examples

Success response

JSON format

{
  "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"
    }
  ],
  "TotalCount": 36,
  "PageNumber": 1,
  "PageSize": 10
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidLifecyclePolicy.NotFound	The specified LifecyclePolicy does not exist.	The specified LifecyclePolicy does not exist.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	The specified file system does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.