PutLifecycleConfiguration - Amazon Elastic File System
请求语法URI 请求参数请求正文响应语法响应元素ErrorsExamples另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

PutLifecycleConfiguration

通过创建新的启用生命周期管理LifecycleConfiguration对象。ALifecycleConfiguration对象定义了 Amazon EFS 文件系统中的文件何时自动转换到成本较低的 EFS 不频繁访问 (IA) 存储类别。要启用 EFS 智能分层，请设置TransitionToPrimaryStorageClass到AFTER_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对象，每个过渡都有一个对象，TransitionToIA、TransitionToPrimaryStorageClass. 有关更多信息，请参阅以下部分中的示例请求。

类型: 数组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 的更多信息，请参阅以下内容：