调用CreateLifecyclePolicy接口创建生命周期管理策略。

接口说明

  • 仅通用型NAS文件系统支持创建生命周期管理策略。
  • 每个阿里云账号在一个地域最多可以创建20个生命周期管理策略。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateLifecyclePolicy

接口名称。

固定取值：CreateLifecyclePolicy
FileSystemId String 是 31a8e4****

文件系统ID。
LifecyclePolicyName String 是 lifecyclepolicy_01

生命周期管理策略名称。

长度为3~64个字符，必须以大写字母或小写字母开头，可以包含英文字母、数字、下划线（_）或者短划线（-）。
Path String 否 /pathway/to/folder

生命周期管理策略关联目录的绝对路径。

仅支持关联单个目录。必须以正斜线（/）开头，并且是挂载点中真实存在的路径。

说明 建议您配置Paths.N，可以同时关联多个目录。
LifecycleRuleName String 是 DEFAULT_ATIME_14

生命周期管理策略关联的管理规则。

取值：

  • DEFAULT_ATIME_14：距今14天未访问的文件
  • DEFAULT_ATIME_30：距今30天未访问的文件
  • DEFAULT_ATIME_60：距今60天未访问的文件
  • DEFAULT_ATIME_90：距今90天未访问的文件
StorageType String 是 InfrequentAccess

数据转储后的存储类型。

默认值：InfrequentAccess（低频介质存储）
Paths.N String 否 “/path1", "/path2"

生命周期管理策略关联目录的绝对路径。

支持关联多个目录。必须以正斜线（/）开头，并且是挂载点中真实存在的路径，N的取值范围为1~10。

返回数据

名称 类型 示例值 描述
RequestId String BC7C825C-5F65-4B56-BEF6-98C56C7C****

请求ID。
Success Boolean true

请求状态。

包括：

  • true：请求成功
  • false：请求失败

示例

请求示例

http(s)://[Endpoint]/?Action=CreateLifecyclePolicy
&FileSystemId=31a8e4****
&LifecyclePolicyName=lifecyclepolicy_01
&LifecycleRuleName=DEFAULT_ATIME_14
&StorageType=InfrequentAccess
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>BC7C825C-5F65-4B56-BEF6-98C56C7C****</RequestId>
<Success>true</Success>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 OperationDenied.FileSystemNotSupportedForLifecycle The file system does not support lifecycle. 指定的文件系统不支持生命周期管理。
400 OperationDenied.EncryptedFileSystemNotSupportedForLifecycle The encrypted file system does not support lifecycle. 加密的文件系统不支持生命周期管理。
400 OperationDenied.LifecyclePolicyCountLimitExceeded The maximum number of LifecyclePolicies is exceeded. 生命周期策略数量达到上限。
400 InvalidLifecyclePolicy.AlreadyExist The specified LifecyclePolicy already exists. 指定的生命周期策略已存在。
400 InvalidParameter.PathsNumberExceed The maximum number of Path.N for this operation is 10. 每个策略最多允许关联10个路径。
400 InvalidFilesystemType.NotSupport The API operation does not support the file system type. 当前接口不支持该类型文件系统。
400 InvalidParameter.PathOrPaths Either Path or Paths.N must be specified. Path 和 Paths.N参数必须指定其中一个，并且不能同时指定。
403 OperationDenied.NotSupportPaths.N Your request does not meet the gray condition. The Paths.N parameter is not supported. 当前请求未通过灰度策略，不持支Paths.N参数。
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的文件系统不存在。
404 InvalidParameter.PathNotExist The specified path does not exist. 指定的路径不存在。

访问错误中心查看更多错误码。