All Products
Search
Document Center

File Storage NAS:StartLifecyclePolicyExecution

Last Updated:Apr 04, 2026

Starts the execution of a lifecycle policy.

Operation description

This operation is supported only when the LifecyclePolicyType of a lifecycle policy is set to OnDemand for a CPFS AI-Computing Edition file system.

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-0015****

LifecyclePolicyId

string

Yes

The lifecycle policy ID.

lc-xxx

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

70EACC9C-D07A-4A34-ADA4-77506C42****

Success

boolean

Indicates whether the request was successful.

Valid values:

  • true: The request was successful.

  • false: The request failed.

true

Examples

Success response

JSON format

{
  "RequestId": "70EACC9C-D07A-4A34-ADA4-77506C42****",
  "Success": true
}

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.
400 Lifecycle.RunningTask.Exist There are running tasks for this lifecycle policy. A file system supports only 2 OnDemand lifecycle policies in operation.
400 MissingFileSystemId FileSystemId is mandatory for this action.
403 OperationDenied.LifecycleLogsCountsExceeded The amount of Lifecycle Logs has reached its limits. The OnDemand lifecycle policy only supports 1 run.
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.