UpdateLifecyclePolicy - 更新生命周期管理策略的规则-文件存储NAS(NAS)-阿里云帮助中心

更新一个生命周期管理策略的规则。仅智算 CPFS 支持。 UpdateLifecyclePolicy 是覆盖语义，非必选参数为空则表示删除对应字段。当您需要追加生命周期规则时，请先调用 DescribeLifecyclePolicies 接口获取当前生命周期规则配置，然后追加新的生命周期规则配置，最后调用 UpdateLifecyclePolicy 接口更新生命周期规则配置。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

nas:UpdateLifecyclePolicy

update

*LifecyclePolicy

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

无

请求参数

名称	类型	必填	描述	示例值
FileSystemId	string	是	文件系统 ID。以 bmcpfs-开头，如 bmcpfs-290w65p03ok64ya****。说明仅 CPFS 智算版文件系统的生命周期管理策略中 LifecyclePolicyType 为 OnDemand 时支持。	bmcpfs-290w65p03ok64y*****
StorageType	string	否	分级存储类型。 InfrequentAccess：低频存储（默认值）。 Archive：归档存储。枚举值： Archive : 归档存储 InfrequentAccess : 低频存储	InfrequentAccess
LifecyclePolicyId	string	是	生命周期策略的 ID。说明 CPFS 智算版文件系统必填。	lsp-bp1234567890ab****
Description	string	否	生命周期策略描述。格式：长度为 3-64 个字符，必须以字母开头，可以包含英文字母、数字、下划线（_）或者短划线（-）。说明仅 CPFS 智算版支持。	Lifecycle policy description
Paths	array	否	生命周期管理策略关联目录的绝对路径。
	string	否	生命周期管理策略关联目录的绝对路径。支持关联多个目录。必须以正斜线（/）开头，并且是挂载点中真实存在的路径，N 的取值范围为 1~10。	/path1
TransitRules	array<object>	否	文件数据转储规则，最多配置 1 个。说明仅 CPFS 智算版文件系统的 LifecyclePolicyType=Auto 时支持
	object	否	文件数据转储规则。
Attribute	string	否	规则的属性。取值： Atime: 文件的访问时间。	Atime
Threshold	string	否	规则的阈值。取值：当 Attribute 为 Atime 时，表示多少天未访问的文件，取值范围[1,365]	3
RetrieveRules	array<object>	否	文件数据取回规则，最多配置 1 个。说明仅 CPFS 智算版文件系统支持。
	object	否	文件数据取回规则。
Attribute	string	否	规则的属性，取值： RetrieveType: 取回方式	RetrieveType
Threshold	string	否	规则的阈值，取值： RetrieveType AfterVisit： LifecyclePolicyType=Auto 支持，代表尽力 recall on visit All: LifecyclePolicyType=OnDemand 支持，代表取回所有枚举值： All : All AfterVisit : AfterVisit	All
DeleteRules	array<object>	否	文件数据过期删除规则。
	object	否	文件数据过期删除规则。
Attribute	string	否	规则的属性。取值： Atime: 文件的访问时间。	Atime
Threshold	string	否	规则的阈值。取值：当 Attribute 为 Atime 时，表示多少天未访问的文件，取值范围[1,365]	4

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	98696EF0-1607-4E9D-B01D-F20930B6****
Success	boolean	请求状态。包括： true：请求成功 false：请求失败	true

示例

正常返回示例

JSON格式

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidLifecyclePolicy.NotFound	The specified LifecyclePolicy does not exist.	指定的生命周期策略不存在。
404	InvalidFileSystem.NotFound	The specified file system does not exist.	指定的文件系统不存在。

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

变更历史

更多信息，参考变更详情。