aws-sdk-efs 1.67.0 → 1.69.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16671f87aea3faee383f8ef802dbe19d9ea1f73405497314ef8e116c710678e0
-  data.tar.gz: 9940d4f64782fa1123aac7e8782817da7f9730d2467b485de7ccfc8d2ced6ea4
+  metadata.gz: f5afd8c3a446341a16c01afcd5cf1c80ad61e3cd716ab7838a27383fc29e9193
+  data.tar.gz: 3286149eef342387f18ed201a75b0d0e2bd73edd0399b95dd4c5692b00ff5096
 SHA512:
-  metadata.gz: d8fbb578e587594c497d643c276b9237d443963a09c79d679425e71a2887621e7c5aeb2ed3d82041fb39f3a4d9e473647cf1690ab4a4cce50f4ed8cd86fd01c5
-  data.tar.gz: 11cad4349aa8de3a54b4e9c6b54b4df1dc5fb4ea184214151d6ec7b95f4a470f0860aa94905029b464d5ad3d6042f3258c1913ff1be06746f4b0ba07ab4a2cf5
+  metadata.gz: 60614ebf4e79e8c46d4be4769f7962bc3030bda7bcdc0c6645a3acd7ce1c8ea1789302ebd081b2b9be609b3d6e77698b47e5a0ee559348502bc0ba5938c8025e
+  data.tar.gz: 841604338076e74e8f2fe8541100ffcc509db1896cfbca1430e2e18536799ea572db39c0bf0ced06bd01a28de837e8e1647037b641cf07e829db6356975a620e

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.69.0 (2023-11-27)
+------------------
+
+* Feature - Adding support for EFS Archive lifecycle configuration.
+
+1.68.0 (2023-11-22)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.67.0 (2023-09-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.67.0
+1.69.0

data/lib/aws-sdk-efs/client.rb

@@ -448,11 +448,11 @@ module Aws::EFS
     #   requests made using the access point.
     #
     # @option params [Types::RootDirectory] :root_directory
-    #   Specifies the directory on the Amazon EFS file system that the access
-    #   point exposes as the root directory of your file system to NFS clients
-    #   using the access point. The clients using the access point can only
-    #   access the root directory and below. If the `RootDirectory` >
-    #   `Path` specified does not exist, EFS creates it and applies the
+    #   Specifies the directory on the EFS file system that the access point
+    #   exposes as the root directory of your file system to NFS clients using
+    #   the access point. The clients using the access point can only access
+    #   the root directory and below. If the `RootDirectory` > `Path`
+    #   specified does not exist, Amazon EFS creates it and applies the
     #   `CreationInfo` settings when a client connects to an access point.
     #   When specifying a `RootDirectory`, you must provide the `Path`, and
     #   the `CreationInfo`.
@@ -573,12 +573,17 @@ module Aws::EFS
     #
     # This operation accepts an optional `PerformanceMode` parameter that
     # you choose for your file system. We recommend `generalPurpose`
-    # performance mode for most file systems. File systems using the `maxIO`
-    # performance mode can scale to higher levels of aggregate throughput
-    # and operations per second with a tradeoff of slightly higher latencies
-    # for most file operations. The performance mode can't be changed after
-    # the file system has been created. For more information, see [Amazon
-    # EFS performance modes][2].
+    # performance mode for all file systems. File systems using the `maxIO`
+    # mode is a previous generation performance type that is designed for
+    # highly parallelized workloads that can tolerate higher latencies than
+    # the General Purpose mode. Max I/O mode is not supported for One Zone
+    # file systems or file systems that use Elastic throughput.
+    #
+    # Due to the higher per-operation latencies with Max I/O, we recommend
+    # using General Purpose performance mode for all file systems.
+    #
+    # The performance mode can't be changed after the file system has been
+    # created. For more information, see [Amazon EFS performance modes][2].
     #
     # You can set the throughput mode for the file system using the
     # `ThroughputMode` parameter.
@@ -616,17 +621,16 @@ module Aws::EFS
     #   not need to pass this option.**
     #
     # @option params [String] :performance_mode
-    #   The performance mode of the file system. We recommend `generalPurpose`
-    #   performance mode for most file systems. File systems using the `maxIO`
+    #   The Performance mode of the file system. We recommend `generalPurpose`
+    #   performance mode for all file systems. File systems using the `maxIO`
     #   performance mode can scale to higher levels of aggregate throughput
     #   and operations per second with a tradeoff of slightly higher latencies
     #   for most file operations. The performance mode can't be changed after
-    #   the file system has been created.
+    #   the file system has been created. The `maxIO` mode is not supported on
+    #   One Zone file systems.
     #
-    #   <note markdown="1"> The `maxIO` mode is not supported on file systems using One Zone
-    #   storage classes.
-    #
-    #    </note>
+    #   Due to the higher per-operation latencies with Max I/O, we recommend
+    #   using General Purpose performance mode for all file systems.
     #
     #   Default is `generalPurpose`.
     #
@@ -668,10 +672,10 @@ module Aws::EFS
     #   `bursting`, `provisioned`, or `elastic`. If you set `ThroughputMode`
     #   to `provisioned`, you must also set a value for
     #   `ProvisionedThroughputInMibps`. After you create the file system, you
-    #   can decrease your file system's throughput in Provisioned Throughput
-    #   mode or change between the throughput modes, with certain time
-    #   restrictions. For more information, see [Specifying throughput with
-    #   provisioned mode][1] in the *Amazon EFS User Guide*.
+    #   can decrease your file system's Provisioned throughput or change
+    #   between the throughput modes, with certain time restrictions. For more
+    #   information, see [Specifying throughput with provisioned mode][1] in
+    #   the *Amazon EFS User Guide*.
     #
     #   Default is `bursting`.
     #
@@ -693,15 +697,14 @@ module Aws::EFS
     #   [1]: https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits
     #
     # @option params [String] :availability_zone_name
-    #   Used to create a file system that uses One Zone storage classes. It
-    #   specifies the Amazon Web Services Availability Zone in which to create
-    #   the file system. Use the format `us-east-1a` to specify the
-    #   Availability Zone. For more information about One Zone storage
-    #   classes, see [Using EFS storage classes][1] in the *Amazon EFS User
-    #   Guide*.
+    #   Used to create a One Zone file system. It specifies the Amazon Web
+    #   Services Availability Zone in which to create the file system. Use the
+    #   format `us-east-1a` to specify the Availability Zone. For more
+    #   information about One Zone file systems, see [Using EFS storage
+    #   classes][1] in the *Amazon EFS User Guide*.
     #
-    #   <note markdown="1"> One Zone storage classes are not available in all Availability Zones
-    #   in Amazon Web Services Regions where Amazon EFS is available.
+    #   <note markdown="1"> One Zone file systems are not available in all Availability Zones in
+    #   Amazon Web Services Regions where Amazon EFS is available.
     #
     #    </note>
     #
@@ -712,10 +715,9 @@ module Aws::EFS
     # @option params [Boolean] :backup
     #   Specifies whether automatic backups are enabled on the file system
     #   that you are creating. Set the value to `true` to enable automatic
-    #   backups. If you are creating a file system that uses One Zone storage
-    #   classes, automatic backups are enabled by default. For more
-    #   information, see [Automatic backups][1] in the *Amazon EFS User
-    #   Guide*.
+    #   backups. If you are creating a One Zone file system, automatic backups
+    #   are enabled by default. For more information, see [Automatic
+    #   backups][1] in the *Amazon EFS User Guide*.
     #
     #   Default is `false`. However, if you specify an `AvailabilityZoneName`,
     #   the default is `true`.
@@ -834,6 +836,7 @@ module Aws::EFS
     #   resp.size_in_bytes.timestamp #=> Time
     #   resp.size_in_bytes.value_in_ia #=> Integer
     #   resp.size_in_bytes.value_in_standard #=> Integer
+    #   resp.size_in_bytes.value_in_archive #=> Integer
     #   resp.performance_mode #=> String, one of "generalPurpose", "maxIO"
     #   resp.encrypted #=> Boolean
     #   resp.kms_key_id #=> String
@@ -864,13 +867,12 @@ module Aws::EFS
     # the subnets. EC2 instances do not need to be in the same subnet as the
     # mount target in order to access their file system.
     #
-    # You can create only one mount target for an EFS file system using One
-    # Zone storage classes. You must create that mount target in the same
-    # Availability Zone in which the file system is located. Use the
-    # `AvailabilityZoneName` and `AvailabiltyZoneId` properties in the
-    # DescribeFileSystems response object to get this information. Use the
-    # `subnetId` associated with the file system's Availability Zone when
-    # creating the mount target.
+    # You can create only one mount target for a One Zone file system. You
+    # must create that mount target in the same Availability Zone in which
+    # the file system is located. Use the `AvailabilityZoneName` and
+    # `AvailabiltyZoneId` properties in the DescribeFileSystems response
+    # object to get this information. Use the `subnetId` associated with the
+    # file system's Availability Zone when creating the mount target.
     #
     # For more information, see [Amazon EFS: How it Works][1].
     #
@@ -986,9 +988,9 @@ module Aws::EFS
     #   The ID of the file system for which to create the mount target.
     #
     # @option params [required, String] :subnet_id
-    #   The ID of the subnet to add the mount target in. For file systems that
-    #   use One Zone storage classes, use the subnet that is associated with
-    #   the file system's Availability Zone.
+    #   The ID of the subnet to add the mount target in. For One Zone file
+    #   systems, use the subnet that is associated with the file system's
+    #   Availability Zone.
     #
     # @option params [String] :ip_address
     #   Valid IPv4 address within the address range of the specified subnet.
@@ -1086,10 +1088,10 @@ module Aws::EFS
     #     *Amazon Web Services General Reference Reference Guide*
     #
     #   * **Availability Zone** - If you want the destination file system to
-    #     use EFS One Zone availability and durability, you must specify the
-    #     Availability Zone to create the file system in. For more
-    #     information about EFS storage classes, see [ Amazon EFS storage
-    #     classes][3] in the *Amazon EFS User Guide*.
+    #     use EFS One Zone availability, you must specify the Availability
+    #     Zone to create the file system in. For more information about EFS
+    #     storage classes, see [ Amazon EFS storage classes][3] in the
+    #     *Amazon EFS User Guide*.
     #
     #   * **Encryption** - All destination file systems are created with
     #     encryption at rest enabled. You can specify the Key Management
@@ -1115,12 +1117,11 @@ module Aws::EFS
     #
     # The following properties are turned off by default:
     #
-    # * **Lifecycle management** - EFS lifecycle management and EFS
-    #   Intelligent-Tiering are not enabled on the destination file system.
-    #   After the destination file system is created, you can enable EFS
-    #   lifecycle management and EFS Intelligent-Tiering.
+    # * **Lifecycle management** – Lifecycle management is not enabled on
+    #   the destination file system. After the destination file system is
+    #   created, you can enable it.
     #
-    # * **Automatic backups** - Automatic daily backups are enabled on the
+    # * **Automatic backups** – Automatic daily backups are enabled on the
     #   destination file system. After the file system is created, you can
     #   change this setting.
     #
@@ -1629,7 +1630,8 @@ module Aws::EFS
     # Returns the backup policy for the specified EFS file system.
     #
     # @option params [required, String] :file_system_id
-    #   Specifies which EFS file system to retrieve the `BackupPolicy` for.
+    #   Specifies which EFS file system for which to retrieve the
+    #   `BackupPolicy`.
     #
     # @return [Types::BackupPolicyDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1801,6 +1803,7 @@ module Aws::EFS
     #   resp.file_systems[0].size_in_bytes.timestamp #=> Time
     #   resp.file_systems[0].size_in_bytes.value_in_ia #=> Integer
     #   resp.file_systems[0].size_in_bytes.value_in_standard #=> Integer
+    #   resp.file_systems[0].size_in_bytes.value_in_archive #=> Integer
     #   resp.file_systems[0].performance_mode #=> String, one of "generalPurpose", "maxIO"
     #   resp.file_systems[0].encrypted #=> Boolean
     #   resp.file_systems[0].kms_key_id #=> String
@@ -1823,14 +1826,10 @@ module Aws::EFS
     end
 
     # Returns the current `LifecycleConfiguration` object for the specified
-    # Amazon EFS file system. EFS lifecycle management uses the
-    # `LifecycleConfiguration` object to identify which files to move to the
-    # EFS Infrequent Access (IA) storage class. For a file system without a
-    # `LifecycleConfiguration` object, the call returns an empty array in
-    # the response.
-    #
-    # When EFS Intelligent-Tiering is enabled,
-    # `TransitionToPrimaryStorageClass` has a value of `AFTER_1_ACCESS`.
+    # Amazon EFS file system. Llifecycle management uses the
+    # `LifecycleConfiguration` object to identify when to move files between
+    # storage classes. For a file system without a `LifecycleConfiguration`
+    # object, the call returns an empty array in the response.
     #
     # This operation requires permissions for the
     # `elasticfilesystem:DescribeLifecycleConfiguration` operation.
@@ -1871,8 +1870,9 @@ module Aws::EFS
     # @example Response structure
     #
     #   resp.lifecycle_policies #=> Array
-    #   resp.lifecycle_policies[0].transition_to_ia #=> String, one of "AFTER_7_DAYS", "AFTER_14_DAYS", "AFTER_30_DAYS", "AFTER_60_DAYS", "AFTER_90_DAYS", "AFTER_1_DAY"
+    #   resp.lifecycle_policies[0].transition_to_ia #=> String, one of "AFTER_7_DAYS", "AFTER_14_DAYS", "AFTER_30_DAYS", "AFTER_60_DAYS", "AFTER_90_DAYS", "AFTER_1_DAY", "AFTER_180_DAYS", "AFTER_270_DAYS", "AFTER_365_DAYS"
     #   resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
+    #   resp.lifecycle_policies[0].transition_to_archive #=> String, one of "AFTER_1_DAY", "AFTER_7_DAYS", "AFTER_14_DAYS", "AFTER_30_DAYS", "AFTER_60_DAYS", "AFTER_90_DAYS", "AFTER_180_DAYS", "AFTER_270_DAYS", "AFTER_365_DAYS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration AWS API Documentation
     #
@@ -1983,6 +1983,8 @@ module Aws::EFS
     #   * {Types::DescribeMountTargetsResponse#mount_targets #mount_targets} => Array&lt;Types::MountTargetDescription&gt;
     #   * {Types::DescribeMountTargetsResponse#next_marker #next_marker} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To describe the mount targets for a file system
     #
@@ -2064,6 +2066,8 @@ module Aws::EFS
     #   * {Types::DescribeReplicationConfigurationsResponse#replications #replications} => Array&lt;Types::ReplicationConfigurationDescription&gt;
     #   * {Types::DescribeReplicationConfigurationsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_replication_configurations({
@@ -2444,25 +2448,33 @@ module Aws::EFS
       req.send_request(options)
     end
 
-    # 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:
+    # Use this action to manage storage of your file system. A
+    # `LifecycleConfiguration` consists of one or more `LifecyclePolicy`
+    # objects that define the following:
+    #
+    # * <b> <code>TransitionToIA</code> </b> – When to move files in the
+    #   file system from primary storage (Standard storage class) into the
+    #   Infrequent Access (IA) storage.
     #
-    # * **EFS Lifecycle management** - When Amazon EFS automatically
-    #   transitions files in a file system into the lower-cost EFS
-    #   Infrequent Access (IA) storage class.
+    # * <b> <code>TransitionToArchive</code> </b> – When to move files in
+    #   the file system from their current storage class (either IA or
+    #   Standard storage) into the Archive storage.
     #
-    #   To enable EFS Lifecycle management, set the value of
-    #   `TransitionToIA` to one of the available options.
+    #   File systems cannot transition into Archive storage before
+    #   transitioning into IA storage. Therefore, TransitionToArchive must
+    #   either not be set or must be later than TransitionToIA.
     #
-    # * **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).
+    #   <note markdown="1"> The Archive storage class is available only for file systems that
+    #   use the Elastic Throughput mode and the General Purpose Performance
+    #   mode.
     #
-    #   To enable EFS Intelligent-Tiering, set the value of
-    #   `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`.
+    #    </note>
     #
-    # For more information, see [EFS Lifecycle Management][1].
+    # * <b> <code>TransitionToPrimaryStorageClass</code> </b> – Whether to
+    #   move files in the file system back to primary storage (Standard
+    #   storage class) after they are accessed in IA or Archive storage.
+    #
+    # For more information, see [ Managing file system storage][1].
     #
     # Each Amazon EFS file system supports one lifecycle configuration,
     # which applies to all files in the file system. If a
@@ -2470,17 +2482,16 @@ module Aws::EFS
     # 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.
+    # `LifecycleConfiguration` 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.
+    #   modifying Lifecycle management.
     #
     # * A `LifecyclePolicies` array of `LifecyclePolicy` objects that define
-    #   when files are moved into IA storage, and when they are moved back
-    #   to Standard storage.
+    #   when to move files to IA storage, to Archive storage, and back to
+    #   primary storage.
     #
     #   <note markdown="1"> Amazon EFS requires that each `LifecyclePolicy` object have only
     #   have a single transition, so the `LifecyclePolicies` array needs to
@@ -2507,21 +2518,37 @@ module Aws::EFS
     # @option params [required, Array<Types::LifecyclePolicy>] :lifecycle_policies
     #   An array of `LifecyclePolicy` objects that define the file system's
     #   `LifecycleConfiguration` object. A `LifecycleConfiguration` object
-    #   informs EFS lifecycle management and EFS Intelligent-Tiering of the
-    #   following:
+    #   informs EFS Lifecycle management of the following:
+    #
+    #   * <b> <code>TransitionToIA</code> </b> – When to move files in the
+    #     file system from primary storage (Standard storage class) into the
+    #     Infrequent Access (IA) storage.
     #
-    #   * When to move files in the file system from primary storage to the IA
-    #     storage class.
+    #   * <b> <code>TransitionToArchive</code> </b> – When to move files in
+    #     the file system from their current storage class (either IA or
+    #     Standard storage) into the Archive storage.
+    #
+    #     File systems cannot transition into Archive storage before
+    #     transitioning into IA storage. Therefore, TransitionToArchive must
+    #     either not be set or must be later than TransitionToIA.
+    #
+    #     <note markdown="1"> The Archive storage class is available only for file systems that
+    #     use the Elastic Throughput mode and the General Purpose Performance
+    #     mode.
+    #
+    #      </note>
     #
-    #   * When to move files that are in IA storage to primary storage.
+    #   * <b> <code>TransitionToPrimaryStorageClass</code> </b> – Whether to
+    #     move files in the file system back to primary storage (Standard
+    #     storage class) after they are accessed in IA or Archive storage.
     #
     #   <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
     #   `PutLifecycleConfiguration` API action, Amazon EFS requires that each
     #   `LifecyclePolicy` object have only a single transition. This means
     #   that in a request body, `LifecyclePolicies` must be structured as an
-    #   array of `LifecyclePolicy` objects, one object for each transition,
-    #   `TransitionToIA`, `TransitionToPrimaryStorageClass`. See the example
-    #   requests in the following section for more information.
+    #   array of `LifecyclePolicy` objects, one object for each storage
+    #   transition. See the example requests in the following section for more
+    #   information.
     #
     #    </note>
     #
@@ -2560,8 +2587,9 @@ module Aws::EFS
     #     file_system_id: "FileSystemId", # required
     #     lifecycle_policies: [ # required
     #       {
-    #         transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS, AFTER_1_DAY
+    #         transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS, AFTER_1_DAY, AFTER_180_DAYS, AFTER_270_DAYS, AFTER_365_DAYS
     #         transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
+    #         transition_to_archive: "AFTER_1_DAY", # accepts AFTER_1_DAY, AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS, AFTER_180_DAYS, AFTER_270_DAYS, AFTER_365_DAYS
     #       },
     #     ],
     #   })
@@ -2569,8 +2597,9 @@ module Aws::EFS
     # @example Response structure
     #
     #   resp.lifecycle_policies #=> Array
-    #   resp.lifecycle_policies[0].transition_to_ia #=> String, one of "AFTER_7_DAYS", "AFTER_14_DAYS", "AFTER_30_DAYS", "AFTER_60_DAYS", "AFTER_90_DAYS", "AFTER_1_DAY"
+    #   resp.lifecycle_policies[0].transition_to_ia #=> String, one of "AFTER_7_DAYS", "AFTER_14_DAYS", "AFTER_30_DAYS", "AFTER_60_DAYS", "AFTER_90_DAYS", "AFTER_1_DAY", "AFTER_180_DAYS", "AFTER_270_DAYS", "AFTER_365_DAYS"
     #   resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
+    #   resp.lifecycle_policies[0].transition_to_archive #=> String, one of "AFTER_1_DAY", "AFTER_7_DAYS", "AFTER_14_DAYS", "AFTER_30_DAYS", "AFTER_60_DAYS", "AFTER_90_DAYS", "AFTER_180_DAYS", "AFTER_270_DAYS", "AFTER_365_DAYS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutLifecycleConfiguration AWS API Documentation
     #
@@ -2716,6 +2745,7 @@ module Aws::EFS
     #   resp.size_in_bytes.timestamp #=> Time
     #   resp.size_in_bytes.value_in_ia #=> Integer
     #   resp.size_in_bytes.value_in_standard #=> Integer
+    #   resp.size_in_bytes.value_in_archive #=> Integer
     #   resp.performance_mode #=> String, one of "generalPurpose", "maxIO"
     #   resp.encrypted #=> Boolean
     #   resp.kms_key_id #=> String
@@ -2749,7 +2779,7 @@ module Aws::EFS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-efs'
-      context[:gem_version] = '1.67.0'
+      context[:gem_version] = '1.69.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-efs/client_api.rb

@@ -154,6 +154,7 @@ module Aws::EFS
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     Token = Shapes::StringShape.new(name: 'Token')
     TooManyRequests = Shapes::StructureShape.new(name: 'TooManyRequests')
+    TransitionToArchiveRules = Shapes::StringShape.new(name: 'TransitionToArchiveRules')
     TransitionToIARules = Shapes::StringShape.new(name: 'TransitionToIARules')
     TransitionToPrimaryStorageClassRules = Shapes::StringShape.new(name: 'TransitionToPrimaryStorageClassRules')
     Uid = Shapes::IntegerShape.new(name: 'Uid')
@@ -400,6 +401,7 @@ module Aws::EFS
     FileSystemSize.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Timestamp"))
     FileSystemSize.add_member(:value_in_ia, Shapes::ShapeRef.new(shape: FileSystemNullableSizeValue, location_name: "ValueInIA"))
     FileSystemSize.add_member(:value_in_standard, Shapes::ShapeRef.new(shape: FileSystemNullableSizeValue, location_name: "ValueInStandard"))
+    FileSystemSize.add_member(:value_in_archive, Shapes::ShapeRef.new(shape: FileSystemNullableSizeValue, location_name: "ValueInArchive"))
     FileSystemSize.struct_class = Types::FileSystemSize
 
     IncorrectFileSystemLifeCycleState.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, required: true, location_name: "ErrorCode"))
@@ -433,6 +435,7 @@ module Aws::EFS
 
     LifecyclePolicy.add_member(:transition_to_ia, Shapes::ShapeRef.new(shape: TransitionToIARules, location_name: "TransitionToIA"))
     LifecyclePolicy.add_member(:transition_to_primary_storage_class, Shapes::ShapeRef.new(shape: TransitionToPrimaryStorageClassRules, location_name: "TransitionToPrimaryStorageClass"))
+    LifecyclePolicy.add_member(:transition_to_archive, Shapes::ShapeRef.new(shape: TransitionToArchiveRules, location_name: "TransitionToArchive"))
     LifecyclePolicy.struct_class = Types::LifecyclePolicy
 
     ListTagsForResourceRequest.add_member(:resource_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location: "uri", location_name: "ResourceId"))
@@ -859,6 +862,12 @@ module Aws::EFS
         o.errors << Shapes::ShapeRef.new(shape: FileSystemNotFound)
         o.errors << Shapes::ShapeRef.new(shape: MountTargetNotFound)
         o.errors << Shapes::ShapeRef.new(shape: AccessPointNotFound)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_items",
+          tokens: {
+            "next_marker" => "marker"
+          }
+        )
       end)
 
       api.add_operation(:describe_replication_configurations, Seahorse::Model::Operation.new.tap do |o|
@@ -872,6 +881,12 @@ module Aws::EFS
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: ReplicationNotFound)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:describe_tags, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-efs/endpoint_provider.rb

@@ -32,7 +32,7 @@ module Aws::EFS
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               return Aws::Endpoints::Endpoint.new(url: "https://elasticfilesystem-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"

data/lib/aws-sdk-efs/types.rb

@@ -78,8 +78,8 @@ module Aws::EFS
     #   @return [Types::PosixUser]
     #
     # @!attribute [rw] root_directory
-    #   The directory on the Amazon EFS file system that the access point
-    #   exposes as the root directory to NFS clients using the access point.
+    #   The directory on the EFS file system that the access point exposes
+    #   as the root directory to NFS clients using the access point.
     #   @return [Types::RootDirectory]
     #
     # @!attribute [rw] owner_id
@@ -216,16 +216,16 @@ module Aws::EFS
     # @!attribute [rw] status
     #   Describes the status of the file system's backup policy.
     #
-    #   * <b> <code>ENABLED</code> </b> - EFS is automatically backing up
+    #   * <b> <code>ENABLED</code> </b> – EFS is automatically backing up
     #     the file system.
     #
-    #   * <b> <code>ENABLING</code> </b> - EFS is turning on automatic
+    #   * <b> <code>ENABLING</code> </b> – EFS is turning on automatic
     #     backups for the file system.
     #
-    #   * <b> <code>DISABLED</code> </b> - Automatic back ups are turned off
+    #   * <b> <code>DISABLED</code> </b> – Automatic back ups are turned off
     #     for the file system.
     #
-    #   * <b> <code>DISABLING</code> </b> - EFS is turning off automatic
+    #   * <b> <code>DISABLING</code> </b> – EFS is turning off automatic
     #     backups for the file system.
     #   @return [String]
     #
@@ -308,14 +308,14 @@ module Aws::EFS
     #   @return [Types::PosixUser]
     #
     # @!attribute [rw] root_directory
-    #   Specifies the directory on the Amazon EFS file system that the
-    #   access point exposes as the root directory of your file system to
-    #   NFS clients using the access point. The clients using the access
-    #   point can only access the root directory and below. If the
-    #   `RootDirectory` &gt; `Path` specified does not exist, EFS creates it
-    #   and applies the `CreationInfo` settings when a client connects to an
-    #   access point. When specifying a `RootDirectory`, you must provide
-    #   the `Path`, and the `CreationInfo`.
+    #   Specifies the directory on the EFS file system that the access point
+    #   exposes as the root directory of your file system to NFS clients
+    #   using the access point. The clients using the access point can only
+    #   access the root directory and below. If the `RootDirectory` &gt;
+    #   `Path` specified does not exist, Amazon EFS creates it and applies
+    #   the `CreationInfo` settings when a client connects to an access
+    #   point. When specifying a `RootDirectory`, you must provide the
+    #   `Path`, and the `CreationInfo`.
     #
     #   Amazon EFS creates a root directory only if you have provided the
     #   CreationInfo: OwnUid, OwnGID, and permissions for the directory. If
@@ -345,18 +345,16 @@ module Aws::EFS
     #   @return [String]
     #
     # @!attribute [rw] performance_mode
-    #   The performance mode of the file system. We recommend
-    #   `generalPurpose` performance mode for most file systems. File
-    #   systems using the `maxIO` performance mode can scale to higher
-    #   levels of aggregate throughput and operations per second with a
-    #   tradeoff of slightly higher latencies for most file operations. The
-    #   performance mode can't be changed after the file system has been
-    #   created.
+    #   The Performance mode of the file system. We recommend
+    #   `generalPurpose` performance mode for all file systems. File systems
+    #   using the `maxIO` performance mode can scale to higher levels of
+    #   aggregate throughput and operations per second with a tradeoff of
+    #   slightly higher latencies for most file operations. The performance
+    #   mode can't be changed after the file system has been created. The
+    #   `maxIO` mode is not supported on One Zone file systems.
     #
-    #   <note markdown="1"> The `maxIO` mode is not supported on file systems using One Zone
-    #   storage classes.
-    #
-    #    </note>
+    #   Due to the higher per-operation latencies with Max I/O, we recommend
+    #   using General Purpose performance mode for all file systems.
     #
     #   Default is `generalPurpose`.
     #   @return [String]
@@ -401,10 +399,10 @@ module Aws::EFS
     #   `bursting`, `provisioned`, or `elastic`. If you set `ThroughputMode`
     #   to `provisioned`, you must also set a value for
     #   `ProvisionedThroughputInMibps`. After you create the file system,
-    #   you can decrease your file system's throughput in Provisioned
-    #   Throughput mode or change between the throughput modes, with certain
-    #   time restrictions. For more information, see [Specifying throughput
-    #   with provisioned mode][1] in the *Amazon EFS User Guide*.
+    #   you can decrease your file system's Provisioned throughput or
+    #   change between the throughput modes, with certain time restrictions.
+    #   For more information, see [Specifying throughput with provisioned
+    #   mode][1] in the *Amazon EFS User Guide*.
     #
     #   Default is `bursting`.
     #
@@ -428,15 +426,14 @@ module Aws::EFS
     #   @return [Float]
     #
     # @!attribute [rw] availability_zone_name
-    #   Used to create a file system that uses One Zone storage classes. It
-    #   specifies the Amazon Web Services Availability Zone in which to
-    #   create the file system. Use the format `us-east-1a` to specify the
-    #   Availability Zone. For more information about One Zone storage
-    #   classes, see [Using EFS storage classes][1] in the *Amazon EFS User
-    #   Guide*.
+    #   Used to create a One Zone file system. It specifies the Amazon Web
+    #   Services Availability Zone in which to create the file system. Use
+    #   the format `us-east-1a` to specify the Availability Zone. For more
+    #   information about One Zone file systems, see [Using EFS storage
+    #   classes][1] in the *Amazon EFS User Guide*.
     #
-    #   <note markdown="1"> One Zone storage classes are not available in all Availability Zones
-    #   in Amazon Web Services Regions where Amazon EFS is available.
+    #   <note markdown="1"> One Zone file systems are not available in all Availability Zones in
+    #   Amazon Web Services Regions where Amazon EFS is available.
     #
     #    </note>
     #
@@ -448,10 +445,9 @@ module Aws::EFS
     # @!attribute [rw] backup
     #   Specifies whether automatic backups are enabled on the file system
     #   that you are creating. Set the value to `true` to enable automatic
-    #   backups. If you are creating a file system that uses One Zone
-    #   storage classes, automatic backups are enabled by default. For more
-    #   information, see [Automatic backups][1] in the *Amazon EFS User
-    #   Guide*.
+    #   backups. If you are creating a One Zone file system, automatic
+    #   backups are enabled by default. For more information, see [Automatic
+    #   backups][1] in the *Amazon EFS User Guide*.
     #
     #   Default is `false`. However, if you specify an
     #   `AvailabilityZoneName`, the default is `true`.
@@ -500,9 +496,9 @@ module Aws::EFS
     #   @return [String]
     #
     # @!attribute [rw] subnet_id
-    #   The ID of the subnet to add the mount target in. For file systems
-    #   that use One Zone storage classes, use the subnet that is associated
-    #   with the file system's Availability Zone.
+    #   The ID of the subnet to add the mount target in. For One Zone file
+    #   systems, use the subnet that is associated with the file system's
+    #   Availability Zone.
     #   @return [String]
     #
     # @!attribute [rw] ip_address
@@ -808,7 +804,8 @@ module Aws::EFS
     end
 
     # @!attribute [rw] file_system_id
-    #   Specifies which EFS file system to retrieve the `BackupPolicy` for.
+    #   Specifies which EFS file system for which to retrieve the
+    #   `BackupPolicy`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeBackupPolicyRequest AWS API Documentation
@@ -1103,7 +1100,7 @@ module Aws::EFS
     # configuration.
     #
     # @!attribute [rw] status
-    #   Describes the status of the destination Amazon EFS file system.
+    #   Describes the status of the destination EFS file system.
     #
     #   * The `Paused` state occurs as a result of opting out of the source
     #     or destination Region after the replication configuration was
@@ -1164,9 +1161,9 @@ module Aws::EFS
     #   @return [String]
     #
     # @!attribute [rw] availability_zone_name
-    #   To create a file system that uses EFS One Zone storage, specify the
-    #   name of the Availability Zone in which to create the destination
-    #   file system.
+    #   To create a file system that uses One Zone storage, specify the name
+    #   of the Availability Zone in which to create the destination file
+    #   system.
     #   @return [String]
     #
     # @!attribute [rw] kms_key_id
@@ -1287,7 +1284,7 @@ module Aws::EFS
     #   @return [Types::FileSystemSize]
     #
     # @!attribute [rw] performance_mode
-    #   The performance mode of the file system.
+    #   The Performance mode of the file system.
     #   @return [String]
     #
     # @!attribute [rw] encrypted
@@ -1316,9 +1313,9 @@ module Aws::EFS
     #
     # @!attribute [rw] availability_zone_name
     #   Describes the Amazon Web Services Availability Zone in which the
-    #   file system is located, and is valid only for file systems using One
-    #   Zone storage classes. For more information, see [Using EFS storage
-    #   classes][1] in the *Amazon EFS User Guide*.
+    #   file system is located, and is valid only for One Zone file systems.
+    #   For more information, see [Using EFS storage classes][1] in the
+    #   *Amazon EFS User Guide*.
     #
     #
     #
@@ -1327,10 +1324,10 @@ module Aws::EFS
     #
     # @!attribute [rw] availability_zone_id
     #   The unique and consistent identifier of the Availability Zone in
-    #   which the file system's One Zone storage classes exist. For
-    #   example, `use1-az1` is an Availability Zone ID for the us-east-1
-    #   Amazon Web Services Region, and it has the same location in every
-    #   Amazon Web Services account.
+    #   which the file system is located, and is valid only for One Zone
+    #   file systems. For example, `use1-az1` is an Availability Zone ID for
+    #   the us-east-1 Amazon Web Services Region, and it has the same
+    #   location in every Amazon Web Services account.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -1494,13 +1491,19 @@ module Aws::EFS
     #   Standard storage class.
     #   @return [Integer]
     #
+    # @!attribute [rw] value_in_archive
+    #   The latest known metered size (in bytes) of data stored in the
+    #   Archive storage class.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/FileSystemSize AWS API Documentation
     #
     class FileSystemSize < Struct.new(
       :value,
       :timestamp,
       :value_in_ia,
-      :value_in_standard)
+      :value_in_standard,
+      :value_in_archive)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1690,19 +1693,18 @@ module Aws::EFS
       include Aws::Structure
     end
 
-    # Describes a policy used by EFS lifecycle management and EFS
-    # Intelligent-Tiering that specifies when to transition files into and
-    # out of the file system's Infrequent Access (IA) storage class. For
-    # more information, see [EFS Intelligent‐Tiering and EFS Lifecycle
-    # Management][1].
+    # Describes a policy used by Lifecycle management that specifies when to
+    # transition files into and out of the Infrequent Access (IA) and
+    # Archive storage classes. For more information, see [Managing file
+    # system storage][1].
     #
     # <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
     # `PutLifecycleConfiguration` API action, Amazon EFS requires that each
     # `LifecyclePolicy` object have only a single transition. This means
     # that in a request body, `LifecyclePolicies` must be structured as an
-    # array of `LifecyclePolicy` objects, one object for each transition,
-    # `TransitionToIA`, `TransitionToPrimaryStorageClass`. For more
-    # information, see the request examples in PutLifecycleConfiguration.
+    # array of `LifecyclePolicy` objects, one object for each transition.
+    # For more information, see the request examples in
+    # PutLifecycleConfiguration.
     #
     #  </note>
     #
@@ -1711,14 +1713,22 @@ module Aws::EFS
     # [1]: https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html
     #
     # @!attribute [rw] transition_to_ia
-    #   Describes the period of time that a file is not accessed, after
-    #   which it transitions to IA storage. Metadata operations such as
+    #   The number of days after files were last accessed in primary storage
+    #   (the Standard storage class) at which to move them to Infrequent
+    #   Access (IA) storage. Metadata operations such as listing the
+    #   contents of a directory don't count as file access events.
+    #   @return [String]
+    #
+    # @!attribute [rw] transition_to_primary_storage_class
+    #   Whether to move files back to primary (Standard) storage after they
+    #   are accessed in IA or Archive storage. Metadata operations such as
     #   listing the contents of a directory don't count as file access
     #   events.
     #   @return [String]
     #
-    # @!attribute [rw] transition_to_primary_storage_class
-    #   Describes when to transition a file from IA storage to primary
+    # @!attribute [rw] transition_to_archive
+    #   The number of days after files were last accessed in primary storage
+    #   (the Standard storage class) files at which to move them to Archive
     #   storage. Metadata operations such as listing the contents of a
     #   directory don't count as file access events.
     #   @return [String]
@@ -1727,7 +1737,8 @@ module Aws::EFS
     #
     class LifecyclePolicy < Struct.new(
       :transition_to_ia,
-      :transition_to_primary_storage_class)
+      :transition_to_primary_storage_class,
+      :transition_to_archive)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2141,21 +2152,37 @@ module Aws::EFS
     # @!attribute [rw] lifecycle_policies
     #   An array of `LifecyclePolicy` objects that define the file system's
     #   `LifecycleConfiguration` object. A `LifecycleConfiguration` object
-    #   informs EFS lifecycle management and EFS Intelligent-Tiering of the
-    #   following:
+    #   informs EFS Lifecycle management of the following:
+    #
+    #   * <b> <code>TransitionToIA</code> </b> – When to move files in the
+    #     file system from primary storage (Standard storage class) into the
+    #     Infrequent Access (IA) storage.
     #
-    #   * When to move files in the file system from primary storage to the
-    #     IA storage class.
+    #   * <b> <code>TransitionToArchive</code> </b> – When to move files in
+    #     the file system from their current storage class (either IA or
+    #     Standard storage) into the Archive storage.
     #
-    #   * When to move files that are in IA storage to primary storage.
+    #     File systems cannot transition into Archive storage before
+    #     transitioning into IA storage. Therefore, TransitionToArchive must
+    #     either not be set or must be later than TransitionToIA.
+    #
+    #     <note markdown="1"> The Archive storage class is available only for file systems that
+    #     use the Elastic Throughput mode and the General Purpose
+    #     Performance mode.
+    #
+    #      </note>
+    #
+    #   * <b> <code>TransitionToPrimaryStorageClass</code> </b> – Whether to
+    #     move files in the file system back to primary storage (Standard
+    #     storage class) after they are accessed in IA or Archive storage.
     #
     #   <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
     #   `PutLifecycleConfiguration` API action, Amazon EFS requires that
     #   each `LifecyclePolicy` object have only a single transition. This
     #   means that in a request body, `LifecyclePolicies` must be structured
     #   as an array of `LifecyclePolicy` objects, one object for each
-    #   transition, `TransitionToIA`, `TransitionToPrimaryStorageClass`. See
-    #   the example requests in the following section for more information.
+    #   storage transition. See the example requests in the following
+    #   section for more information.
     #
     #    </note>
     #   @return [Array<Types::LifecyclePolicy>]
@@ -2177,8 +2204,8 @@ module Aws::EFS
     #   @return [String]
     #
     # @!attribute [rw] source_file_system_region
-    #   The Amazon Web Services Region in which the source Amazon EFS file
-    #   system is located.
+    #   The Amazon Web Services Region in which the source EFS file system
+    #   is located.
     #   @return [String]
     #
     # @!attribute [rw] source_file_system_arn
@@ -2187,8 +2214,8 @@ module Aws::EFS
     #   @return [String]
     #
     # @!attribute [rw] original_source_file_system_arn
-    #   The Amazon Resource Name (ARN) of the original source Amazon EFS
-    #   file system in the replication configuration.
+    #   The Amazon Resource Name (ARN) of the original source EFS file
+    #   system in the replication configuration.
     #   @return [String]
     #
     # @!attribute [rw] creation_time

data/lib/aws-sdk-efs.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-efs/customizations'
 # @!group service
 module Aws::EFS
 
-  GEM_VERSION = '1.67.0'
+  GEM_VERSION = '1.69.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-efs
 version: !ruby/object:Gem::Version
-  version: 1.67.0
+  version: 1.69.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-27 00:00:00.000000000 Z
+date: 2023-11-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.184.0
+        version: 3.188.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.184.0
+        version: 3.188.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -80,7 +80,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="