Creates a lifecycle policy.
Operation description
- You can create lifecycle policies only for General-purpose NAS file systems.
- You can create up to 20 lifecycle policies in each region within an Alibaba Cloud account.
Debugging
Authorization information
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| FileSystemId | string | Yes | The ID of the file system. | 31a8e4**** |
| LifecyclePolicyName | string | Yes | The name of the lifecycle policy. The name must be 3 to 64 characters in length and can contain letters, digits, underscores (_), and hyphens (-). The name must start with a letter. | lifecyclepolicy_01 |
| Path | string | No | The absolute path of the directory that is associated with the lifecycle policy. If you specify this parameter, you can associate the lifecycle policy with only one directory. The path must start with a forward slash (/) and must be a path that exists in the mount target. Note
We recommend that you specify the Paths.N parameter so that you can associate the lifecycle policy with multiple directories.
| /pathway/to/folder |
| LifecycleRuleName | string | Yes | The management rule that is associated with the lifecycle policy. Valid values:
Enumeration Value:
| DEFAULT_ATIME_14 |
| StorageType | string | Yes | The storage type of the data that is dumped to the IA storage medium. Default value: InfrequentAccess (IA). | InfrequentAccess |
| Paths | array | No | The absolute paths of the directories that are associated with the lifecycle policy. If you specify this parameter, you can associate the lifecycle policy with multiple directories. Each path must start with a forward slash (/) and must be a path that exists in the mount target. Valid values of N: 1 to 10. | |
| string | No | The absolute path of the directory that is associated with the lifecycle policy. If you specify this parameter, you can associate the lifecycle policy with multiple directories. Each path must start with a forward slash (/) and must be a path that exists in the mount target. Valid values of N: 1 to 10. | “/path1", "/path2" |
Response parameters
Examples
Sample success responses
JSONformat
{
"RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
"Success": true
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | OperationDenied.FileSystemNotSupportedForLifecycle | The file system does not support lifecycle. | The file system does not support lifecycle. |
| 400 | OperationDenied.EncryptedFileSystemNotSupportedForLifecycle | The encrypted file system does not support lifecycle. | The encrypted file system does not support lifecycle. |
| 400 | OperationDenied.LifecyclePolicyCountLimitExceeded | The maximum number of LifecyclePolicies is exceeded. | The maximum number of LifecyclePolicies is exceeded. |
| 400 | InvalidLifecyclePolicy.AlreadyExist | The specified LifecyclePolicy already exists. | The specified LifecyclePolicy already exists. |
| 400 | InvalidParameter.PathsNumberExceed | The maximum number of Path.N for this operation is 10. | The maximum number of Path.N for this operation is 10. |
| 400 | InvalidFilesystemType.NotSupport | The API operation does not support the file system type. | The API operation does not support the file system type. |
| 400 | InvalidParameter.PathOrPaths | Either Path or Paths.N must be specified. | Either Path or Paths.N must be specified. |
| 403 | OperationDenied.NotSupportPaths.N | Your request does not meet the gray condition. The Paths.N parameter is not supported. | Your request does not meet the gray condition. The Paths.N parameter is not supported. |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | The specified file system does not exist. |
| 404 | InvalidParameter.PathNotExist | The specified path does not exist. | The specified path does not exist. |
For a list of error codes, visit the Service error codes.