aws-sdk-efs 1.68.0 → 1.70.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 605509d2c21d9dfe18caa55cb800dd61a07467d26c5e98944fa74926d8e20c59
4
- data.tar.gz: acc7adaf3e5bf553b47508f21a42a4d674f19ac208231aa71733a25d5c79b46e
3
+ metadata.gz: 8d9833a46ade82415822242e86624e7cb8abd4ee841f2f5d7531d70179cfde07
4
+ data.tar.gz: 0a67296ab993855261e0c1c0d01cee4ccd0acf56245e40430ec52fedf0380d96
5
5
  SHA512:
6
- metadata.gz: 10ec9d499ea96274e5112b85cc83f872a959cc4a33dbfb17e61f4de268d35efb6791109117d659b28f2a4ae0ffdd7cb02871830dc048d30bbdbcadcf2d6e2746
7
- data.tar.gz: a95f46f0263486d48d0e36bc967efde592ddca5853b3bd62e005d3e6c8d76e780d9dadf7d407f359e66155f09acde2c97e4f74b5d864ea4a2f032f348bc7a821
6
+ metadata.gz: 0a260e97791f090c813b122841f6e8e5ba55da73c1f7814bffe9e27da7407cddd72590a9b774345ae149ff1ef8b43550afc04d804ed0b9f985245181c4724da9
7
+ data.tar.gz: 5ee0ccddfb6f944d0d6d3e9a32c6b0ce181d4908b9f5718c2156074ac351d5fa01f682cc32abc63ca11f236c041dd697d525078d6db3aedd0263654f9a257a29
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.70.0 (2023-11-27)
5
+ ------------------
6
+
7
+ * Feature - Adding support for EFS Replication to existing file system.
8
+
9
+ 1.69.0 (2023-11-27)
10
+ ------------------
11
+
12
+ * Feature - Adding support for EFS Archive lifecycle configuration.
13
+
4
14
  1.68.0 (2023-11-22)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.68.0
1
+ 1.70.0
@@ -448,11 +448,11 @@ module Aws::EFS
448
448
  # requests made using the access point.
449
449
  #
450
450
  # @option params [Types::RootDirectory] :root_directory
451
- # Specifies the directory on the Amazon EFS file system that the access
452
- # point exposes as the root directory of your file system to NFS clients
453
- # using the access point. The clients using the access point can only
454
- # access the root directory and below. If the `RootDirectory` >
455
- # `Path` specified does not exist, EFS creates it and applies the
451
+ # Specifies the directory on the EFS file system that the access point
452
+ # exposes as the root directory of your file system to NFS clients using
453
+ # the access point. The clients using the access point can only access
454
+ # the root directory and below. If the `RootDirectory` > `Path`
455
+ # specified does not exist, Amazon EFS creates it and applies the
456
456
  # `CreationInfo` settings when a client connects to an access point.
457
457
  # When specifying a `RootDirectory`, you must provide the `Path`, and
458
458
  # the `CreationInfo`.
@@ -573,12 +573,17 @@ module Aws::EFS
573
573
  #
574
574
  # This operation accepts an optional `PerformanceMode` parameter that
575
575
  # you choose for your file system. We recommend `generalPurpose`
576
- # performance mode for most file systems. File systems using the `maxIO`
577
- # performance mode can scale to higher levels of aggregate throughput
578
- # and operations per second with a tradeoff of slightly higher latencies
579
- # for most file operations. The performance mode can't be changed after
580
- # the file system has been created. For more information, see [Amazon
581
- # EFS performance modes][2].
576
+ # performance mode for all file systems. File systems using the `maxIO`
577
+ # mode is a previous generation performance type that is designed for
578
+ # highly parallelized workloads that can tolerate higher latencies than
579
+ # the General Purpose mode. Max I/O mode is not supported for One Zone
580
+ # file systems or file systems that use Elastic throughput.
581
+ #
582
+ # Due to the higher per-operation latencies with Max I/O, we recommend
583
+ # using General Purpose performance mode for all file systems.
584
+ #
585
+ # The performance mode can't be changed after the file system has been
586
+ # created. For more information, see [Amazon EFS performance modes][2].
582
587
  #
583
588
  # You can set the throughput mode for the file system using the
584
589
  # `ThroughputMode` parameter.
@@ -616,17 +621,16 @@ module Aws::EFS
616
621
  # not need to pass this option.**
617
622
  #
618
623
  # @option params [String] :performance_mode
619
- # The performance mode of the file system. We recommend `generalPurpose`
620
- # performance mode for most file systems. File systems using the `maxIO`
624
+ # The Performance mode of the file system. We recommend `generalPurpose`
625
+ # performance mode for all file systems. File systems using the `maxIO`
621
626
  # performance mode can scale to higher levels of aggregate throughput
622
627
  # and operations per second with a tradeoff of slightly higher latencies
623
628
  # for most file operations. The performance mode can't be changed after
624
- # the file system has been created.
629
+ # the file system has been created. The `maxIO` mode is not supported on
630
+ # One Zone file systems.
625
631
  #
626
- # <note markdown="1"> The `maxIO` mode is not supported on file systems using One Zone
627
- # storage classes.
628
- #
629
- # </note>
632
+ # Due to the higher per-operation latencies with Max I/O, we recommend
633
+ # using General Purpose performance mode for all file systems.
630
634
  #
631
635
  # Default is `generalPurpose`.
632
636
  #
@@ -668,10 +672,10 @@ module Aws::EFS
668
672
  # `bursting`, `provisioned`, or `elastic`. If you set `ThroughputMode`
669
673
  # to `provisioned`, you must also set a value for
670
674
  # `ProvisionedThroughputInMibps`. After you create the file system, you
671
- # can decrease your file system's throughput in Provisioned Throughput
672
- # mode or change between the throughput modes, with certain time
673
- # restrictions. For more information, see [Specifying throughput with
674
- # provisioned mode][1] in the *Amazon EFS User Guide*.
675
+ # can decrease your file system's Provisioned throughput or change
676
+ # between the throughput modes, with certain time restrictions. For more
677
+ # information, see [Specifying throughput with provisioned mode][1] in
678
+ # the *Amazon EFS User Guide*.
675
679
  #
676
680
  # Default is `bursting`.
677
681
  #
@@ -693,15 +697,14 @@ module Aws::EFS
693
697
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits
694
698
  #
695
699
  # @option params [String] :availability_zone_name
696
- # Used to create a file system that uses One Zone storage classes. It
697
- # specifies the Amazon Web Services Availability Zone in which to create
698
- # the file system. Use the format `us-east-1a` to specify the
699
- # Availability Zone. For more information about One Zone storage
700
- # classes, see [Using EFS storage classes][1] in the *Amazon EFS User
701
- # Guide*.
700
+ # Used to create a One Zone file system. It specifies the Amazon Web
701
+ # Services Availability Zone in which to create the file system. Use the
702
+ # format `us-east-1a` to specify the Availability Zone. For more
703
+ # information about One Zone file systems, see [Using EFS storage
704
+ # classes][1] in the *Amazon EFS User Guide*.
702
705
  #
703
- # <note markdown="1"> One Zone storage classes are not available in all Availability Zones
704
- # in Amazon Web Services Regions where Amazon EFS is available.
706
+ # <note markdown="1"> One Zone file systems are not available in all Availability Zones in
707
+ # Amazon Web Services Regions where Amazon EFS is available.
705
708
  #
706
709
  # </note>
707
710
  #
@@ -712,10 +715,9 @@ module Aws::EFS
712
715
  # @option params [Boolean] :backup
713
716
  # Specifies whether automatic backups are enabled on the file system
714
717
  # that you are creating. Set the value to `true` to enable automatic
715
- # backups. If you are creating a file system that uses One Zone storage
716
- # classes, automatic backups are enabled by default. For more
717
- # information, see [Automatic backups][1] in the *Amazon EFS User
718
- # Guide*.
718
+ # backups. If you are creating a One Zone file system, automatic backups
719
+ # are enabled by default. For more information, see [Automatic
720
+ # backups][1] in the *Amazon EFS User Guide*.
719
721
  #
720
722
  # Default is `false`. However, if you specify an `AvailabilityZoneName`,
721
723
  # the default is `true`.
@@ -760,6 +762,7 @@ module Aws::EFS
760
762
  # * {Types::FileSystemDescription#availability_zone_name #availability_zone_name} => String
761
763
  # * {Types::FileSystemDescription#availability_zone_id #availability_zone_id} => String
762
764
  # * {Types::FileSystemDescription#tags #tags} => Array&lt;Types::Tag&gt;
765
+ # * {Types::FileSystemDescription#file_system_protection #file_system_protection} => Types::FileSystemProtectionDescription
763
766
  #
764
767
  #
765
768
  # @example Example: To create a new file system
@@ -834,6 +837,7 @@ module Aws::EFS
834
837
  # resp.size_in_bytes.timestamp #=> Time
835
838
  # resp.size_in_bytes.value_in_ia #=> Integer
836
839
  # resp.size_in_bytes.value_in_standard #=> Integer
840
+ # resp.size_in_bytes.value_in_archive #=> Integer
837
841
  # resp.performance_mode #=> String, one of "generalPurpose", "maxIO"
838
842
  # resp.encrypted #=> Boolean
839
843
  # resp.kms_key_id #=> String
@@ -844,6 +848,7 @@ module Aws::EFS
844
848
  # resp.tags #=> Array
845
849
  # resp.tags[0].key #=> String
846
850
  # resp.tags[0].value #=> String
851
+ # resp.file_system_protection.replication_overwrite_protection #=> String, one of "ENABLED", "DISABLED", "REPLICATING"
847
852
  #
848
853
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateFileSystem AWS API Documentation
849
854
  #
@@ -864,13 +869,12 @@ module Aws::EFS
864
869
  # the subnets. EC2 instances do not need to be in the same subnet as the
865
870
  # mount target in order to access their file system.
866
871
  #
867
- # You can create only one mount target for an EFS file system using One
868
- # Zone storage classes. You must create that mount target in the same
869
- # Availability Zone in which the file system is located. Use the
870
- # `AvailabilityZoneName` and `AvailabiltyZoneId` properties in the
871
- # DescribeFileSystems response object to get this information. Use the
872
- # `subnetId` associated with the file system's Availability Zone when
873
- # creating the mount target.
872
+ # You can create only one mount target for a One Zone file system. You
873
+ # must create that mount target in the same Availability Zone in which
874
+ # the file system is located. Use the `AvailabilityZoneName` and
875
+ # `AvailabiltyZoneId` properties in the DescribeFileSystems response
876
+ # object to get this information. Use the `subnetId` associated with the
877
+ # file system's Availability Zone when creating the mount target.
874
878
  #
875
879
  # For more information, see [Amazon EFS: How it Works][1].
876
880
  #
@@ -986,9 +990,9 @@ module Aws::EFS
986
990
  # The ID of the file system for which to create the mount target.
987
991
  #
988
992
  # @option params [required, String] :subnet_id
989
- # The ID of the subnet to add the mount target in. For file systems that
990
- # use One Zone storage classes, use the subnet that is associated with
991
- # the file system's Availability Zone.
993
+ # The ID of the subnet to add the mount target in. For One Zone file
994
+ # systems, use the subnet that is associated with the file system's
995
+ # Availability Zone.
992
996
  #
993
997
  # @option params [String] :ip_address
994
998
  # Valid IPv4 address within the address range of the specified subnet.
@@ -1067,31 +1071,37 @@ module Aws::EFS
1067
1071
  # [Amazon EFS replication][1] in the *Amazon EFS User Guide*. The
1068
1072
  # replication configuration specifies the following:
1069
1073
  #
1070
- # * **Source file system** - An existing EFS file system that you want
1074
+ # * **Source file system** The EFS file system that you want
1071
1075
  # replicated. The source file system cannot be a destination file
1072
1076
  # system in an existing replication configuration.
1073
1077
  #
1074
- # * **Destination file system configuration** - The configuration of the
1078
+ # * **Amazon Web Services Region** The Amazon Web Services Region in
1079
+ # which the destination file system is created. Amazon EFS replication
1080
+ # is available in all Amazon Web Services Regions in which EFS is
1081
+ # available. The Region must be enabled. For more information, see
1082
+ # [Managing Amazon Web Services Regions][2] in the *Amazon Web
1083
+ # Services General Reference Reference Guide*.
1084
+ #
1085
+ # * **Destination file system configuration** – The configuration of the
1075
1086
  # destination file system to which the source file system will be
1076
1087
  # replicated. There can only be one destination file system in a
1077
- # replication configuration. The destination file system configuration
1078
- # consists of the following properties:
1079
- #
1080
- # * **Amazon Web Services Region** - The Amazon Web Services Region in
1081
- # which the destination file system is created. Amazon EFS
1082
- # replication is available in all Amazon Web Services Regions in
1083
- # which EFS is available. To use EFS replication in a Region that is
1084
- # disabled by default, you must first opt in to the Region. For more
1085
- # information, see [Managing Amazon Web Services Regions][2] in the
1086
- # *Amazon Web Services General Reference Reference Guide*
1087
- #
1088
- # * **Availability Zone** - If you want the destination file system to
1089
- # use EFS One Zone availability and durability, you must specify the
1090
- # Availability Zone to create the file system in. For more
1091
- # information about EFS storage classes, see [ Amazon EFS storage
1092
- # classes][3] in the *Amazon EFS User Guide*.
1093
- #
1094
- # * **Encryption** - All destination file systems are created with
1088
+ # replication configuration.
1089
+ #
1090
+ # Parameters for the replication configuration include:
1091
+ #
1092
+ # * **File system ID** – The ID of the destination file system for the
1093
+ # replication. If no ID is provided, then EFS creates a new file
1094
+ # system with the default settings. For existing file systems, the
1095
+ # file system's replication overwrite protection must be disabled.
1096
+ # For more information, see [ Replicating to an existing file
1097
+ # system][3].
1098
+ #
1099
+ # * **Availability Zone** If you want the destination file system to
1100
+ # use One Zone storage, you must specify the Availability Zone to
1101
+ # create the file system in. For more information, see [ EFS file
1102
+ # system types][4] in the *Amazon EFS User Guide*.
1103
+ #
1104
+ # * **Encryption** – All destination file systems are created with
1095
1105
  # encryption at rest enabled. You can specify the Key Management
1096
1106
  # Service (KMS) key that is used to encrypt the destination file
1097
1107
  # system. If you don't specify a KMS key, your service-managed KMS
@@ -1101,7 +1111,12 @@ module Aws::EFS
1101
1111
  #
1102
1112
  # </note>
1103
1113
  #
1104
- # The following properties are set by default:
1114
+ # <note markdown="1"> After the file system is created, you cannot change the KMS key.
1115
+ #
1116
+ # </note>
1117
+ #
1118
+ # For new destination file systems, the following properties are set by
1119
+ # default:
1105
1120
  #
1106
1121
  # * **Performance mode** - The destination file system's performance
1107
1122
  # mode matches that of the source file system, unless the destination
@@ -1112,15 +1127,13 @@ module Aws::EFS
1112
1127
  # * **Throughput mode** - The destination file system's throughput mode
1113
1128
  # matches that of the source file system. After the file system is
1114
1129
  # created, you can modify the throughput mode.
1130
+ # ^
1115
1131
  #
1116
- # The following properties are turned off by default:
1117
- #
1118
- # * **Lifecycle management** - EFS lifecycle management and EFS
1119
- # Intelligent-Tiering are not enabled on the destination file system.
1120
- # After the destination file system is created, you can enable EFS
1121
- # lifecycle management and EFS Intelligent-Tiering.
1132
+ # * **Lifecycle management** Lifecycle management is not enabled on
1133
+ # the destination file system. After the destination file system is
1134
+ # created, you can enable lifecycle management.
1122
1135
  #
1123
- # * **Automatic backups** - Automatic daily backups are enabled on the
1136
+ # * **Automatic backups** Automatic daily backups are enabled on the
1124
1137
  # destination file system. After the file system is created, you can
1125
1138
  # change this setting.
1126
1139
  #
@@ -1131,7 +1144,8 @@ module Aws::EFS
1131
1144
  #
1132
1145
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html
1133
1146
  # [2]: https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable
1134
- # [3]: https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html
1147
+ # [3]: https://docs.aws.amazon.com/efs/latest/ug/efs-replication#replicate-existing-destination
1148
+ # [4]: https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html
1135
1149
  #
1136
1150
  # @option params [required, String] :source_file_system_id
1137
1151
  # Specifies the Amazon EFS file system that you want to replicate. This
@@ -1160,6 +1174,7 @@ module Aws::EFS
1160
1174
  # region: "RegionName",
1161
1175
  # availability_zone_name: "AvailabilityZoneName",
1162
1176
  # kms_key_id: "KmsKeyId",
1177
+ # file_system_id: "FileSystemId",
1163
1178
  # },
1164
1179
  # ],
1165
1180
  # })
@@ -1429,11 +1444,18 @@ module Aws::EFS
1429
1444
  req.send_request(options)
1430
1445
  end
1431
1446
 
1432
- # Deletes an existing replication configuration. Deleting a replication
1447
+ # Deletes a replication configuration. Deleting a replication
1433
1448
  # configuration ends the replication process. After a replication
1434
- # configuration is deleted, the destination file system is no longer
1435
- # read-only. You can write to the destination file system after its
1436
- # status becomes `Writeable`.
1449
+ # configuration is deleted, the destination file system becomes
1450
+ # `Writeable` and its replication overwrite protection is re-enabled.
1451
+ # For more information, see [Delete a replication configuration][1].
1452
+ #
1453
+ # This operation requires permissions for the
1454
+ # `elasticfilesystem:DeleteReplicationConfiguration` action.
1455
+ #
1456
+ #
1457
+ #
1458
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html
1437
1459
  #
1438
1460
  # @option params [required, String] :source_file_system_id
1439
1461
  # The ID of the source file system in the replication configuration.
@@ -1629,7 +1651,8 @@ module Aws::EFS
1629
1651
  # Returns the backup policy for the specified EFS file system.
1630
1652
  #
1631
1653
  # @option params [required, String] :file_system_id
1632
- # Specifies which EFS file system to retrieve the `BackupPolicy` for.
1654
+ # Specifies which EFS file system for which to retrieve the
1655
+ # `BackupPolicy`.
1633
1656
  #
1634
1657
  # @return [Types::BackupPolicyDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1635
1658
  #
@@ -1801,6 +1824,7 @@ module Aws::EFS
1801
1824
  # resp.file_systems[0].size_in_bytes.timestamp #=> Time
1802
1825
  # resp.file_systems[0].size_in_bytes.value_in_ia #=> Integer
1803
1826
  # resp.file_systems[0].size_in_bytes.value_in_standard #=> Integer
1827
+ # resp.file_systems[0].size_in_bytes.value_in_archive #=> Integer
1804
1828
  # resp.file_systems[0].performance_mode #=> String, one of "generalPurpose", "maxIO"
1805
1829
  # resp.file_systems[0].encrypted #=> Boolean
1806
1830
  # resp.file_systems[0].kms_key_id #=> String
@@ -1811,6 +1835,7 @@ module Aws::EFS
1811
1835
  # resp.file_systems[0].tags #=> Array
1812
1836
  # resp.file_systems[0].tags[0].key #=> String
1813
1837
  # resp.file_systems[0].tags[0].value #=> String
1838
+ # resp.file_systems[0].file_system_protection.replication_overwrite_protection #=> String, one of "ENABLED", "DISABLED", "REPLICATING"
1814
1839
  # resp.next_marker #=> String
1815
1840
  #
1816
1841
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeFileSystems AWS API Documentation
@@ -1823,14 +1848,10 @@ module Aws::EFS
1823
1848
  end
1824
1849
 
1825
1850
  # Returns the current `LifecycleConfiguration` object for the specified
1826
- # Amazon EFS file system. EFS lifecycle management uses the
1827
- # `LifecycleConfiguration` object to identify which files to move to the
1828
- # EFS Infrequent Access (IA) storage class. For a file system without a
1829
- # `LifecycleConfiguration` object, the call returns an empty array in
1830
- # the response.
1831
- #
1832
- # When EFS Intelligent-Tiering is enabled,
1833
- # `TransitionToPrimaryStorageClass` has a value of `AFTER_1_ACCESS`.
1851
+ # Amazon EFS file system. Lifecycle management uses the
1852
+ # `LifecycleConfiguration` object to identify when to move files between
1853
+ # storage classes. For a file system without a `LifecycleConfiguration`
1854
+ # object, the call returns an empty array in the response.
1834
1855
  #
1835
1856
  # This operation requires permissions for the
1836
1857
  # `elasticfilesystem:DescribeLifecycleConfiguration` operation.
@@ -1871,8 +1892,9 @@ module Aws::EFS
1871
1892
  # @example Response structure
1872
1893
  #
1873
1894
  # resp.lifecycle_policies #=> Array
1874
- # 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"
1895
+ # 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"
1875
1896
  # resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
1897
+ # 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"
1876
1898
  #
1877
1899
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration AWS API Documentation
1878
1900
  #
@@ -1983,6 +2005,8 @@ module Aws::EFS
1983
2005
  # * {Types::DescribeMountTargetsResponse#mount_targets #mount_targets} => Array&lt;Types::MountTargetDescription&gt;
1984
2006
  # * {Types::DescribeMountTargetsResponse#next_marker #next_marker} => String
1985
2007
  #
2008
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2009
+ #
1986
2010
  #
1987
2011
  # @example Example: To describe the mount targets for a file system
1988
2012
  #
@@ -2064,6 +2088,8 @@ module Aws::EFS
2064
2088
  # * {Types::DescribeReplicationConfigurationsResponse#replications #replications} => Array&lt;Types::ReplicationConfigurationDescription&gt;
2065
2089
  # * {Types::DescribeReplicationConfigurationsResponse#next_token #next_token} => String
2066
2090
  #
2091
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2092
+ #
2067
2093
  # @example Request syntax with placeholder values
2068
2094
  #
2069
2095
  # resp = client.describe_replication_configurations({
@@ -2444,25 +2470,36 @@ module Aws::EFS
2444
2470
  req.send_request(options)
2445
2471
  end
2446
2472
 
2447
- # Use this action to manage EFS lifecycle management and EFS
2448
- # Intelligent-Tiering. A `LifecycleConfiguration` consists of one or
2449
- # more `LifecyclePolicy` objects that define the following:
2473
+ # Use this action to manage storage for your file system. A
2474
+ # `LifecycleConfiguration` consists of one or more `LifecyclePolicy`
2475
+ # objects that define the following:
2476
+ #
2477
+ # * <b> <code>TransitionToIA</code> </b> – When to move files in the
2478
+ # file system from primary storage (Standard storage class) into the
2479
+ # Infrequent Access (IA) storage.
2480
+ #
2481
+ # * <b> <code>TransitionToArchive</code> </b> – When to move files in
2482
+ # the file system from their current storage class (either IA or
2483
+ # Standard storage) into the Archive storage.
2450
2484
  #
2451
- # * **EFS Lifecycle management** - When Amazon EFS automatically
2452
- # transitions files in a file system into the lower-cost EFS
2453
- # Infrequent Access (IA) storage class.
2485
+ # File systems cannot transition into Archive storage before
2486
+ # transitioning into IA storage. Therefore, TransitionToArchive must
2487
+ # either not be set or must be later than TransitionToIA.
2454
2488
  #
2455
- # To enable EFS Lifecycle management, set the value of
2456
- # `TransitionToIA` to one of the available options.
2489
+ # <note markdown="1"> The Archive storage class is available only for file systems that
2490
+ # use the Elastic Throughput mode and the General Purpose Performance
2491
+ # mode.
2457
2492
  #
2458
- # * **EFS Intelligent-Tiering** - When Amazon EFS automatically
2459
- # transitions files from IA back into the file system's primary
2460
- # storage class (EFS Standard or EFS One Zone Standard).
2493
+ # </note>
2494
+ # ^
2461
2495
  #
2462
- # To enable EFS Intelligent-Tiering, set the value of
2463
- # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`.
2496
+ # * <b> <code>TransitionToPrimaryStorageClass</code> </b> Whether to
2497
+ # move files in the file system back to primary storage (Standard
2498
+ # storage class) after they are accessed in IA or Archive storage.
2499
+ #
2500
+ # ^
2464
2501
  #
2465
- # For more information, see [EFS Lifecycle Management][1].
2502
+ # For more information, see [ Managing file system storage][1].
2466
2503
  #
2467
2504
  # Each Amazon EFS file system supports one lifecycle configuration,
2468
2505
  # which applies to all files in the file system. If a
@@ -2470,17 +2507,14 @@ module Aws::EFS
2470
2507
  # system, a `PutLifecycleConfiguration` call modifies the existing
2471
2508
  # configuration. A `PutLifecycleConfiguration` call with an empty
2472
2509
  # `LifecyclePolicies` array in the request body deletes any existing
2473
- # `LifecycleConfiguration` and turns off lifecycle management and EFS
2474
- # Intelligent-Tiering for the file system.
2475
- #
2476
- # In the request, specify the following:
2510
+ # `LifecycleConfiguration`. In the request, specify the following:
2477
2511
  #
2478
2512
  # * The ID for the file system for which you are enabling, disabling, or
2479
- # modifying lifecycle management and EFS Intelligent-Tiering.
2513
+ # modifying Lifecycle management.
2480
2514
  #
2481
2515
  # * A `LifecyclePolicies` array of `LifecyclePolicy` objects that define
2482
- # when files are moved into IA storage, and when they are moved back
2483
- # to Standard storage.
2516
+ # when to move files to IA storage, to Archive storage, and back to
2517
+ # primary storage.
2484
2518
  #
2485
2519
  # <note markdown="1"> Amazon EFS requires that each `LifecyclePolicy` object have only
2486
2520
  # have a single transition, so the `LifecyclePolicies` array needs to
@@ -2507,21 +2541,37 @@ module Aws::EFS
2507
2541
  # @option params [required, Array<Types::LifecyclePolicy>] :lifecycle_policies
2508
2542
  # An array of `LifecyclePolicy` objects that define the file system's
2509
2543
  # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
2510
- # informs EFS lifecycle management and EFS Intelligent-Tiering of the
2511
- # following:
2544
+ # informs EFS Lifecycle management of the following:
2545
+ #
2546
+ # * <b> <code>TransitionToIA</code> </b> – When to move files in the
2547
+ # file system from primary storage (Standard storage class) into the
2548
+ # Infrequent Access (IA) storage.
2549
+ #
2550
+ # * <b> <code>TransitionToArchive</code> </b> – When to move files in
2551
+ # the file system from their current storage class (either IA or
2552
+ # Standard storage) into the Archive storage.
2553
+ #
2554
+ # File systems cannot transition into Archive storage before
2555
+ # transitioning into IA storage. Therefore, TransitionToArchive must
2556
+ # either not be set or must be later than TransitionToIA.
2512
2557
  #
2513
- # * When to move files in the file system from primary storage to the IA
2514
- # storage class.
2558
+ # <note markdown="1"> The Archive storage class is available only for file systems that
2559
+ # use the Elastic Throughput mode and the General Purpose Performance
2560
+ # mode.
2515
2561
  #
2516
- # * When to move files that are in IA storage to primary storage.
2562
+ # </note>
2563
+ #
2564
+ # * <b> <code>TransitionToPrimaryStorageClass</code> </b> – Whether to
2565
+ # move files in the file system back to primary storage (Standard
2566
+ # storage class) after they are accessed in IA or Archive storage.
2517
2567
  #
2518
2568
  # <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
2519
2569
  # `PutLifecycleConfiguration` API action, Amazon EFS requires that each
2520
2570
  # `LifecyclePolicy` object have only a single transition. This means
2521
2571
  # that in a request body, `LifecyclePolicies` must be structured as an
2522
- # array of `LifecyclePolicy` objects, one object for each transition,
2523
- # `TransitionToIA`, `TransitionToPrimaryStorageClass`. See the example
2524
- # requests in the following section for more information.
2572
+ # array of `LifecyclePolicy` objects, one object for each storage
2573
+ # transition. See the example requests in the following section for more
2574
+ # information.
2525
2575
  #
2526
2576
  # </note>
2527
2577
  #
@@ -2560,8 +2610,9 @@ module Aws::EFS
2560
2610
  # file_system_id: "FileSystemId", # required
2561
2611
  # lifecycle_policies: [ # required
2562
2612
  # {
2563
- # 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
2613
+ # 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
2564
2614
  # transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
2615
+ # 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
2565
2616
  # },
2566
2617
  # ],
2567
2618
  # })
@@ -2569,8 +2620,9 @@ module Aws::EFS
2569
2620
  # @example Response structure
2570
2621
  #
2571
2622
  # resp.lifecycle_policies #=> Array
2572
- # 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"
2623
+ # 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"
2573
2624
  # resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
2625
+ # 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"
2574
2626
  #
2575
2627
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutLifecycleConfiguration AWS API Documentation
2576
2628
  #
@@ -2693,6 +2745,7 @@ module Aws::EFS
2693
2745
  # * {Types::FileSystemDescription#availability_zone_name #availability_zone_name} => String
2694
2746
  # * {Types::FileSystemDescription#availability_zone_id #availability_zone_id} => String
2695
2747
  # * {Types::FileSystemDescription#tags #tags} => Array&lt;Types::Tag&gt;
2748
+ # * {Types::FileSystemDescription#file_system_protection #file_system_protection} => Types::FileSystemProtectionDescription
2696
2749
  #
2697
2750
  # @example Request syntax with placeholder values
2698
2751
  #
@@ -2716,6 +2769,7 @@ module Aws::EFS
2716
2769
  # resp.size_in_bytes.timestamp #=> Time
2717
2770
  # resp.size_in_bytes.value_in_ia #=> Integer
2718
2771
  # resp.size_in_bytes.value_in_standard #=> Integer
2772
+ # resp.size_in_bytes.value_in_archive #=> Integer
2719
2773
  # resp.performance_mode #=> String, one of "generalPurpose", "maxIO"
2720
2774
  # resp.encrypted #=> Boolean
2721
2775
  # resp.kms_key_id #=> String
@@ -2726,6 +2780,7 @@ module Aws::EFS
2726
2780
  # resp.tags #=> Array
2727
2781
  # resp.tags[0].key #=> String
2728
2782
  # resp.tags[0].value #=> String
2783
+ # resp.file_system_protection.replication_overwrite_protection #=> String, one of "ENABLED", "DISABLED", "REPLICATING"
2729
2784
  #
2730
2785
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/UpdateFileSystem AWS API Documentation
2731
2786
  #
@@ -2736,6 +2791,57 @@ module Aws::EFS
2736
2791
  req.send_request(options)
2737
2792
  end
2738
2793
 
2794
+ # Updates protection on the file system.
2795
+ #
2796
+ # This operation requires permissions for the
2797
+ # `elasticfilesystem:UpdateFileSystemProtection` action.
2798
+ #
2799
+ # @option params [required, String] :file_system_id
2800
+ # The ID of the file system to update.
2801
+ #
2802
+ # @option params [String] :replication_overwrite_protection
2803
+ # The status of the file system's replication overwrite protection.
2804
+ #
2805
+ # * `ENABLED` – The file system cannot be used as the destination file
2806
+ # system in a replication configuration. The file system is writeable.
2807
+ # Replication overwrite protection is `ENABLED` by default.
2808
+ #
2809
+ # * `DISABLED` – The file system can be used as the destination file
2810
+ # system in a replication configuration. The file system is read-only
2811
+ # and can only be modified by EFS replication.
2812
+ #
2813
+ # * `REPLICATING` – The file system is being used as the destination
2814
+ # file system in a replication configuration. The file system is
2815
+ # read-only and is only modified only by EFS replication.
2816
+ #
2817
+ # If the replication configuration is deleted, the file system's
2818
+ # replication overwrite protection is re-enabled, the file system
2819
+ # becomes writeable.
2820
+ #
2821
+ # @return [Types::FileSystemProtectionDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2822
+ #
2823
+ # * {Types::FileSystemProtectionDescription#replication_overwrite_protection #replication_overwrite_protection} => String
2824
+ #
2825
+ # @example Request syntax with placeholder values
2826
+ #
2827
+ # resp = client.update_file_system_protection({
2828
+ # file_system_id: "FileSystemId", # required
2829
+ # replication_overwrite_protection: "ENABLED", # accepts ENABLED, DISABLED, REPLICATING
2830
+ # })
2831
+ #
2832
+ # @example Response structure
2833
+ #
2834
+ # resp.replication_overwrite_protection #=> String, one of "ENABLED", "DISABLED", "REPLICATING"
2835
+ #
2836
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/UpdateFileSystemProtection AWS API Documentation
2837
+ #
2838
+ # @overload update_file_system_protection(params = {})
2839
+ # @param [Hash] params ({})
2840
+ def update_file_system_protection(params = {}, options = {})
2841
+ req = build_request(:update_file_system_protection, params)
2842
+ req.send_request(options)
2843
+ end
2844
+
2739
2845
  # @!endgroup
2740
2846
 
2741
2847
  # @param params ({})
@@ -2749,7 +2855,7 @@ module Aws::EFS
2749
2855
  params: params,
2750
2856
  config: config)
2751
2857
  context[:gem_name] = 'aws-sdk-efs'
2752
- context[:gem_version] = '1.68.0'
2858
+ context[:gem_version] = '1.70.0'
2753
2859
  Seahorse::Client::Request.new(handlers, context)
2754
2860
  end
2755
2861