---
title: "PUT /2015-02-01/file-systems/{FileSystemId}/lifecycle-configuration"
method: PUT
path: "/2015-02-01/file-systems/{FileSystemId}/lifecycle-configuration"
---

# PUT /2015-02-01/file-systems/{FileSystemId}/lifecycle-configuration

`PUT /2015-02-01/file-systems/{FileSystemId}/lifecycle-configuration`

Use this action to manage EFS lifecycle management and EFS Intelligent-Tiering. A `LifecycleConfiguration` consists of one or more `LifecyclePolicy` objects that define the following:

*   **EFS Lifecycle management** - When Amazon EFS automatically transitions files in a file system into the lower-cost EFS Infrequent Access (IA) storage class.
    
    To enable EFS Lifecycle management, set the value of `TransitionToIA` to one of the available options.
    
*   **EFS Intelligent-Tiering** - When Amazon EFS automatically transitions files from IA back into the file system's primary storage class (EFS Standard or EFS One Zone Standard).
    
    To enable EFS Intelligent-Tiering, set the value of `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`.
    

For more information, see [EFS Lifecycle Management](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).

Each Amazon EFS file system supports one lifecycle configuration, which applies to all files in the file system. If a `LifecycleConfiguration` object already exists for the specified file system, a `PutLifecycleConfiguration` call modifies the existing configuration. A `PutLifecycleConfiguration` call with an empty `LifecyclePolicies` array in the request body deletes any existing `LifecycleConfiguration` and turns off lifecycle management and EFS Intelligent-Tiering for the file system.

In the request, specify the following:

*   The ID for the file system for which you are enabling, disabling, or modifying lifecycle management and EFS Intelligent-Tiering.
    
*   A `LifecyclePolicies` array of `LifecyclePolicy` objects that define when files are moved into IA storage, and when they are moved back to Standard storage.
    
    Amazon EFS requires that each `LifecyclePolicy` object have only have a single transition, so the `LifecyclePolicies` array needs to be structured with separate `LifecyclePolicy` objects. See the example requests in the following section for more information.
    

This operation requires permissions for the `elasticfilesystem:PutLifecycleConfiguration` operation.

To apply a `LifecycleConfiguration` object to an encrypted file system, you need the same Key Management Service permissions as when you created the encrypted file system.

## Path parameters

- `FileSystemId` string, required

## Request body

- object
  - `LifecyclePolicies` LifecyclePolicy[], required — <p>An array of <code>LifecyclePolicy</code> objects that define the file system's <code>LifecycleConfiguration</code> object. A <code>LifecycleConfiguration</code> object informs EFS lifecycle management and EFS Intelligent-Tiering of the following:</p> <ul> <li> <p>When to move files in the file system from primary storage to the IA storage class.</p> </li> <li> <p>When to move files that are in IA storage to primary storage.</p> </li> </ul> <note> <p>When using the <code>put-lifecycle-configuration</code> CLI command or the <code>PutLifecycleConfiguration</code> API action, Amazon EFS requires that each <code>LifecyclePolicy</code> object have only a single transition. This means that in a request body, <code>LifecyclePolicies</code> must be structured as an array of <code>LifecyclePolicy</code> objects, one object for each transition, <code>TransitionToIA</code>, <code>TransitionToPrimaryStorageClass</code>. See the example requests in the following section for more information.</p> </note>
    - `TransitionToIA` 'AFTER_7_DAYS' | 'AFTER_14_DAYS' | 'AFTER_30_DAYS' | 'AFTER_60_DAYS' | 'AFTER_90_DAYS' | 'AFTER_1_DAY' — Describes the period of time that a file is not accessed, after which it transitions to IA storage. Metadata operations such as listing the contents of a directory don't count as file access events.
    - `TransitionToPrimaryStorageClass` 'AFTER_1_ACCESS' — Describes when to transition a file from IA storage to primary storage. Metadata operations such as listing the contents of a directory don't count as file access events.

## Response `200`

Success

- LifecycleConfigurationDescription
  - `LifecyclePolicies` LifecyclePolicy[] — An array of lifecycle management policies. EFS supports a maximum of one policy per file system.
    - `TransitionToIA` 'AFTER_7_DAYS' | 'AFTER_14_DAYS' | 'AFTER_30_DAYS' | 'AFTER_60_DAYS' | 'AFTER_90_DAYS' | 'AFTER_1_DAY' — Describes the period of time that a file is not accessed, after which it transitions to IA storage. Metadata operations such as listing the contents of a directory don't count as file access events.
    - `TransitionToPrimaryStorageClass` 'AFTER_1_ACCESS' — Describes when to transition a file from IA storage to primary storage. Metadata operations such as listing the contents of a directory don't count as file access events.

## Other responses

- `480` — BadRequest
- `481` — InternalServerError
- `482` — FileSystemNotFound
- `483` — IncorrectFileSystemLifeCycleState

---

[API](https://skmtc.net/aws/apis/elasticfilesystem.md) · [All operations](https://skmtc.net/aws/apis/elasticfilesystem/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/elasticfilesystem/revisions/bd410c1b597a/schema)