PutLifecycleConfiguration - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

PutLifecycleConfiguration

通过创建新的启用生命周期管理LifecycleConfiguration对象。ALifecycleConfiguration对象定义了 Amazon EFS 文件系统中的文件何时自动转换到成本较低的 EFS 不频繁访问 (IA) 存储类别。要启用 EFS 智能分层,请设置TransitionToPrimaryStorageClassAFTER_1_ACCESS. 有关更多信息,请参阅 EFS 生命周期管理

每个 Amazon EFS 文件系统都支持一种生命周期配置,该配置适用于文件系统中的所有文件。如果LifecycleConfiguration对于指定的文件系统已存在对象,PutLifecycleConfiguration调用修改现有配置。APutLifecycleConfiguration用空打电话LifecyclePolicies请求正文中的数组删除任何现有的LifecycleConfiguration并关闭文件系统的生命周期管理。

在请求中,指定以下内容:

  • 启用、禁用或修改生命周期管理的文件系统的 ID。

  • ALifecyclePolicies数组LifecyclePolicy定义何时将文件移动到 IA 存储类的对象。亚马逊 EFS 要求LifecyclePolicy对象只有一个过渡,所以LifecyclePolicies数组需要使用单独的结构LifecyclePolicy对象。有关更多信息,请参阅以下部分中的示例请求。

此操作需要授予的权限elasticfilesystem:PutLifecycleConfigurationoperation.

要应用LifecycleConfiguration对象到加密的文件系统,你需要同样的Amazon Key Management Service与创建加密文件系统时一样的权限。

请求语法

PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] }

URI 请求参数

请求使用以下 URI 参数。

FileSystemId

您为其创建的文件系统的 IDLifecycleConfiguration对象(字符串)。

长度约束:长度上限为 128。

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

:必需 是

请求正文

请求接受采用 JSON 格式的以下数据。

LifecyclePolicies

数组LifecyclePolicy定义文件系统的对象LifecycleConfiguration对象。ALifecycleConfiguration对象通知 EFS 生命周期管理和智能分层以下内容:

  • 何时将文件系统中的文件从主存储移动到 IA 存储类。

  • 何时将 IA 存储中的文件移动到主存储器。

注意

使用put-lifecycle-configurationCLI 或PutLifecycleConfigurationAPI 操作,Amazon EFS 要求LifecyclePolicy对象只有一个过渡。这意味着在请求正文中,LifecyclePolicies需要将其结构化为一系列LifecyclePolicy对象,每个过渡都有一个对象,TransitionToIATransitionToPrimaryStorageClass. 有关更多信息,请参阅以下部分中的示例请求。

类型: 数组LifecyclePolicyobjects

数组成员:最多 2 项。

:必需 是

响应语法

HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

LifecyclePolicies

一系列生命周期管理策略。对于每个文件系统,EFS 支持最多一个策略。

类型: 数组LifecyclePolicyobjects

数组成员:最多 2 项。

Errors

BadRequest

如果请求格式不正确或包含错误,例如无效的参数值或缺少必需参数,则返回此选项。

HTTP 状态代码:400

FileSystemNotFound

返回指定的FileSystemId在请求者中不存在该值Amazon Web Services 账户.

HTTP 状态代码:404

IncorrectFileSystemLifeCycleState

如果文件系统的生命周期状态不是 “可用”,则返回。

HTTP 状态代码:409

InternalServerError

如果服务器端发生错误,则返回。

HTTP 状态代码:500

Examples

创建生命周期配置

下面的示例创建LifecyclePolicy对象使用 PutLifeCycle 配置操作。此对象告诉 EFS 生命周期管理执行以下操作:

  • 将文件系统中过去 30 天内未访问过的所有文件移至 IA 存储类。

  • 在 IA 中首次访问之后,将 IA 存储中的文件移动到主存储。

有关更多信息,请参阅 。EFS 存储类EFS 智能分层和生命周期管理.

示例请求

PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToIA": "AFTER_60_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] }

示例响应

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToIA": "AFTER_60_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] }

示例放置生命周期配置 CLI 请求

此示例说明了 PutLifeCycle 配置的一种用法。

示例请求

aws efs put-lifecycle-configuration \ --file-system-id fs-1234567890abcdef1 \ --lifecycle-policies "[{\"TransitionToIA\":\"AFTER_60_DAYS\"},{\"TransitionToPrimaryStorageClass\":\"AFTER_1_ACCESS\"}]" \ --region us-west-2 \ --profile adminuser

示例响应

{ "LifecyclePolicies": [ { "TransitionToIA": "AFTER_60_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] }

禁用生命周期管

以下示例禁用指定文件系统的生命周期管理。

示例请求

PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] }

示例响应

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] }

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: