aws-sdk-efs 1.49.0 → 1.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -27,7 +27,11 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
- require 'aws-sdk-core/plugins/signature_v4.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
+ require 'aws-sdk-core/plugins/request_compression.rb'
32
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
33
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
34
+ require 'aws-sdk-core/plugins/sign.rb'
31
35
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
32
36
 
33
37
  Aws::Plugins::GlobalConfiguration.add_identifier(:efs)
@@ -73,8 +77,13 @@ module Aws::EFS
73
77
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
74
78
  add_plugin(Aws::Plugins::TransferEncoding)
75
79
  add_plugin(Aws::Plugins::HttpChecksum)
76
- add_plugin(Aws::Plugins::SignatureV4)
80
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
81
+ add_plugin(Aws::Plugins::RequestCompression)
82
+ add_plugin(Aws::Plugins::DefaultsMode)
83
+ add_plugin(Aws::Plugins::RecursionDetection)
84
+ add_plugin(Aws::Plugins::Sign)
77
85
  add_plugin(Aws::Plugins::Protocols::RestJson)
86
+ add_plugin(Aws::EFS::Plugins::Endpoints)
78
87
 
79
88
  # @overload initialize(options)
80
89
  # @param [Hash] options
@@ -175,10 +184,18 @@ module Aws::EFS
175
184
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
176
185
  # a clock skew correction and retry requests with skewed client clocks.
177
186
  #
187
+ # @option options [String] :defaults_mode ("legacy")
188
+ # See {Aws::DefaultsModeConfiguration} for a list of the
189
+ # accepted modes and the configuration defaults that are included.
190
+ #
178
191
  # @option options [Boolean] :disable_host_prefix_injection (false)
179
192
  # Set to true to disable SDK automatically adding host prefix
180
193
  # to default service endpoint when available.
181
194
  #
195
+ # @option options [Boolean] :disable_request_compression (false)
196
+ # When set to 'true' the request body will not be compressed
197
+ # for supported operations.
198
+ #
182
199
  # @option options [String] :endpoint
183
200
  # The client endpoint is normally constructed from the `:region`
184
201
  # option. You should only configure an `:endpoint` when connecting
@@ -199,6 +216,10 @@ module Aws::EFS
199
216
  # @option options [Boolean] :endpoint_discovery (false)
200
217
  # When set to `true`, endpoint discovery will be enabled for operations when available.
201
218
  #
219
+ # @option options [Boolean] :ignore_configured_endpoint_urls
220
+ # Setting to true disables use of endpoint URLs provided via environment
221
+ # variables and the shared configuration file.
222
+ #
202
223
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
203
224
  # The log formatter.
204
225
  #
@@ -219,6 +240,11 @@ module Aws::EFS
219
240
  # Used when loading credentials from the shared credentials file
220
241
  # at HOME/.aws/credentials. When not specified, 'default' is used.
221
242
  #
243
+ # @option options [Integer] :request_min_compression_size_bytes (10240)
244
+ # The minimum size in bytes that triggers compression for request
245
+ # bodies. The value must be non-negative integer value between 0
246
+ # and 10485780 bytes inclusive.
247
+ #
222
248
  # @option options [Proc] :retry_backoff
223
249
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
224
250
  # This option is only used in the `legacy` retry mode.
@@ -264,6 +290,11 @@ module Aws::EFS
264
290
  # in the future.
265
291
  #
266
292
  #
293
+ # @option options [String] :sdk_ua_app_id
294
+ # A unique and opaque application ID that is appended to the
295
+ # User-Agent header as app/<sdk_ua_app_id>. It should have a
296
+ # maximum length of 50.
297
+ #
267
298
  # @option options [String] :secret_access_key
268
299
  #
269
300
  # @option options [String] :session_token
@@ -277,6 +308,19 @@ module Aws::EFS
277
308
  # ** Please note ** When response stubbing is enabled, no HTTP
278
309
  # requests are made, and retries are disabled.
279
310
  #
311
+ # @option options [Aws::TokenProvider] :token_provider
312
+ # A Bearer Token Provider. This can be an instance of any one of the
313
+ # following classes:
314
+ #
315
+ # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
316
+ # tokens.
317
+ #
318
+ # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
319
+ # access token generated from `aws login`.
320
+ #
321
+ # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
322
+ # will be used to search for tokens configured for your profile in shared configuration files.
323
+ #
280
324
  # @option options [Boolean] :use_dualstack_endpoint
281
325
  # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
282
326
  # will be used if available.
@@ -290,6 +334,9 @@ module Aws::EFS
290
334
  # When `true`, request parameters are validated before
291
335
  # sending the request.
292
336
  #
337
+ # @option options [Aws::EFS::EndpointProvider] :endpoint_provider
338
+ # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::EFS::EndpointParameters`
339
+ #
293
340
  # @option options [URI::HTTP,String] :http_proxy A proxy to send
294
341
  # requests through. Formatted like 'http://proxy.com:123'.
295
342
  #
@@ -297,7 +344,7 @@ module Aws::EFS
297
344
  # seconds to wait when opening a HTTP session before raising a
298
345
  # `Timeout::Error`.
299
346
  #
300
- # @option options [Integer] :http_read_timeout (60) The default
347
+ # @option options [Float] :http_read_timeout (60) The default
301
348
  # number of seconds to wait for response data. This value can
302
349
  # safely be set per-request on the session.
303
350
  #
@@ -313,6 +360,9 @@ module Aws::EFS
313
360
  # disables this behaviour. This value can safely be set per
314
361
  # request on the session.
315
362
  #
363
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
364
+ # in seconds.
365
+ #
316
366
  # @option options [Boolean] :http_wire_trace (false) When `true`,
317
367
  # HTTP debug output will be sent to the `:logger`.
318
368
  #
@@ -345,15 +395,32 @@ module Aws::EFS
345
395
  # user and group override any identity information provided by the NFS
346
396
  # client. The file system path is exposed as the access point's root
347
397
  # directory. Applications using the access point can only access data in
348
- # its own directory and below. To learn more, see [Mounting a file
349
- # system using EFS access points][1].
398
+ # the application's own directory and any subdirectories. To learn
399
+ # more, see [Mounting a file system using EFS access points][1].
400
+ #
401
+ # <note markdown="1"> If multiple requests to create access points on the same file system
402
+ # are sent in quick succession, and the file system is near the limit of
403
+ # 1,000 access points, you may experience a throttling response for
404
+ # these requests. This is to ensure that the file system does not exceed
405
+ # the stated access point limit.
406
+ #
407
+ # </note>
350
408
  #
351
409
  # This operation requires permissions for the
352
410
  # `elasticfilesystem:CreateAccessPoint` action.
353
411
  #
412
+ # Access points can be tagged on creation. If tags are specified in the
413
+ # creation action, IAM performs additional authorization on the
414
+ # `elasticfilesystem:TagResource` action to verify if users have
415
+ # permissions to create tags. Therefore, you must grant explicit
416
+ # permissions to use the `elasticfilesystem:TagResource` action. For
417
+ # more information, see [Granting permissions to tag resources during
418
+ # creation][2].
419
+ #
354
420
  #
355
421
  #
356
422
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html
423
+ # [2]: https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html
357
424
  #
358
425
  # @option params [required, String] :client_token
359
426
  # A string of up to 64 ASCII characters that Amazon EFS uses to ensure
@@ -387,7 +454,7 @@ module Aws::EFS
387
454
  # access the root directory and below. If the `RootDirectory` &gt;
388
455
  # `Path` specified does not exist, EFS creates it and applies the
389
456
  # `CreationInfo` settings when a client connects to an access point.
390
- # When specifying a `RootDirectory`, you need to provide the `Path`, and
457
+ # When specifying a `RootDirectory`, you must provide the `Path`, and
391
458
  # the `CreationInfo`.
392
459
  #
393
460
  # Amazon EFS creates a root directory only if you have provided the
@@ -526,11 +593,20 @@ module Aws::EFS
526
593
  # This operation requires permissions for the
527
594
  # `elasticfilesystem:CreateFileSystem` action.
528
595
  #
596
+ # File systems can be tagged on creation. If tags are specified in the
597
+ # creation action, IAM performs additional authorization on the
598
+ # `elasticfilesystem:TagResource` action to verify if users have
599
+ # permissions to create tags. Therefore, you must grant explicit
600
+ # permissions to use the `elasticfilesystem:TagResource` action. For
601
+ # more information, see [Granting permissions to tag resources during
602
+ # creation][4].
603
+ #
529
604
  #
530
605
  #
531
606
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1
532
607
  # [2]: https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html
533
608
  # [3]: https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html
609
+ # [4]: https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html
534
610
  #
535
611
  # @option params [required, String] :creation_token
536
612
  # A string of up to 64 ASCII characters. Amazon EFS uses this to ensure
@@ -552,20 +628,22 @@ module Aws::EFS
552
628
  #
553
629
  # </note>
554
630
  #
631
+ # Default is `generalPurpose`.
632
+ #
555
633
  # @option params [Boolean] :encrypted
556
634
  # A Boolean value that, if true, creates an encrypted file system. When
557
635
  # creating an encrypted file system, you have the option of specifying
558
- # CreateFileSystemRequest$KmsKeyId for an existing Key Management
559
- # Service (KMS customer master key (CMK). If you don't specify a CMK,
560
- # then the default CMK for Amazon EFS, `/aws/elasticfilesystem`, is used
561
- # to protect the encrypted file system.
636
+ # an existing Key Management Service key (KMS key). If you don't
637
+ # specify a KMS key, then the default KMS key for Amazon EFS,
638
+ # `/aws/elasticfilesystem`, is used to protect the encrypted file
639
+ # system.
562
640
  #
563
641
  # @option params [String] :kms_key_id
564
- # The ID of the KMS CMK that you want to use to protect the encrypted
565
- # file system. This parameter is only required if you want to use a
642
+ # The ID of the KMS key that you want to use to protect the encrypted
643
+ # file system. This parameter is required only if you want to use a
566
644
  # non-default KMS key. If this parameter is not specified, the default
567
- # CMK for Amazon EFS is used. This ID can be in one of the following
568
- # formats:
645
+ # KMS key for Amazon EFS is used. You can specify a KMS key ID using the
646
+ # following formats:
569
647
  #
570
648
  # * Key ID - A unique identifier of the key, for example
571
649
  # `1234abcd-12ab-34cd-56ef-1234567890ab`.
@@ -579,22 +657,21 @@ module Aws::EFS
579
657
  # * Key alias ARN - An ARN for a key alias, for example
580
658
  # `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
581
659
  #
582
- # If `KmsKeyId` is specified, the CreateFileSystemRequest$Encrypted
583
- # parameter must be set to true.
660
+ # If you use `KmsKeyId`, you must set the
661
+ # CreateFileSystemRequest$Encrypted parameter to true.
584
662
  #
585
663
  # EFS accepts only symmetric KMS keys. You cannot use asymmetric KMS
586
- # keys with EFS file systems.
664
+ # keys with Amazon EFS file systems.
587
665
  #
588
666
  # @option params [String] :throughput_mode
589
- # Specifies the throughput mode for the file system, either `bursting`
590
- # or `provisioned`. If you set `ThroughputMode` to `provisioned`, you
591
- # must also set a value for `ProvisionedThroughputInMibps`. After you
592
- # create the file system, you can decrease your file system's
593
- # throughput in Provisioned Throughput mode or change between the
594
- # throughput modes, as long as it’s been more than 24 hours since the
595
- # last decrease or throughput mode change. For more information, see
596
- # [Specifying throughput with provisioned mode][1] in the *Amazon EFS
597
- # User Guide*.
667
+ # Specifies the throughput mode for the file system. The mode can be
668
+ # `bursting`, `provisioned`, or `elastic`. If you set `ThroughputMode`
669
+ # to `provisioned`, you must also set a value for
670
+ # `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*.
598
675
  #
599
676
  # Default is `bursting`.
600
677
  #
@@ -603,12 +680,13 @@ module Aws::EFS
603
680
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput
604
681
  #
605
682
  # @option params [Float] :provisioned_throughput_in_mibps
606
- # The throughput, measured in MiB/s, that you want to provision for a
607
- # file system that you're creating. Valid values are 1-1024. Required
608
- # if `ThroughputMode` is set to `provisioned`. The upper limit for
609
- # throughput is 1024 MiB/s. To increase this limit, contact Amazon Web
610
- # Services Support. For more information, see [Amazon EFS quotas that
611
- # you can increase][1] in the *Amazon EFS User Guide*.
683
+ # The throughput, measured in mebibytes per second (MiBps), that you
684
+ # want to provision for a file system that you're creating. Required if
685
+ # `ThroughputMode` is set to `provisioned`. Valid values are 1-3414
686
+ # MiBps, with the upper limit depending on Region. To increase this
687
+ # limit, contact Amazon Web Services Support. For more information, see
688
+ # [Amazon EFS quotas that you can increase][1] in the *Amazon EFS User
689
+ # Guide*.
612
690
  #
613
691
  #
614
692
  #
@@ -642,8 +720,8 @@ module Aws::EFS
642
720
  # Default is `false`. However, if you specify an `AvailabilityZoneName`,
643
721
  # the default is `true`.
644
722
  #
645
- # <note markdown="1"> Backup is not available in all Amazon Web Services Regionswhere Amazon
646
- # EFS is available.
723
+ # <note markdown="1"> Backup is not available in all Amazon Web Services Regions where
724
+ # Amazon EFS is available.
647
725
  #
648
726
  # </note>
649
727
  #
@@ -730,7 +808,7 @@ module Aws::EFS
730
808
  # performance_mode: "generalPurpose", # accepts generalPurpose, maxIO
731
809
  # encrypted: false,
732
810
  # kms_key_id: "KmsKeyId",
733
- # throughput_mode: "bursting", # accepts bursting, provisioned
811
+ # throughput_mode: "bursting", # accepts bursting, provisioned, elastic
734
812
  # provisioned_throughput_in_mibps: 1.0,
735
813
  # availability_zone_name: "AvailabilityZoneName",
736
814
  # backup: false,
@@ -759,7 +837,7 @@ module Aws::EFS
759
837
  # resp.performance_mode #=> String, one of "generalPurpose", "maxIO"
760
838
  # resp.encrypted #=> Boolean
761
839
  # resp.kms_key_id #=> String
762
- # resp.throughput_mode #=> String, one of "bursting", "provisioned"
840
+ # resp.throughput_mode #=> String, one of "bursting", "provisioned", "elastic"
763
841
  # resp.provisioned_throughput_in_mibps #=> Float
764
842
  # resp.availability_zone_name #=> String
765
843
  # resp.availability_zone_id #=> String
@@ -984,8 +1062,132 @@ module Aws::EFS
984
1062
  req.send_request(options)
985
1063
  end
986
1064
 
987
- # <note markdown="1"> DEPRECATED - CreateTags is deprecated and not maintained. Please use
988
- # the API action to create tags for EFS resources.
1065
+ # Creates a replication configuration that replicates an existing EFS
1066
+ # file system to a new, read-only file system. For more information, see
1067
+ # [Amazon EFS replication][1] in the *Amazon EFS User Guide*. The
1068
+ # replication configuration specifies the following:
1069
+ #
1070
+ # * **Source file system** - An existing EFS file system that you want
1071
+ # replicated. The source file system cannot be a destination file
1072
+ # system in an existing replication configuration.
1073
+ #
1074
+ # * **Destination file system configuration** - The configuration of the
1075
+ # destination file system to which the source file system will be
1076
+ # 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
1095
+ # encryption at rest enabled. You can specify the Key Management
1096
+ # Service (KMS) key that is used to encrypt the destination file
1097
+ # system. If you don't specify a KMS key, your service-managed KMS
1098
+ # key for Amazon EFS is used.
1099
+ #
1100
+ # <note markdown="1"> After the file system is created, you cannot change the KMS key.
1101
+ #
1102
+ # </note>
1103
+ #
1104
+ # The following properties are set by default:
1105
+ #
1106
+ # * **Performance mode** - The destination file system's performance
1107
+ # mode matches that of the source file system, unless the destination
1108
+ # file system uses EFS One Zone storage. In that case, the General
1109
+ # Purpose performance mode is used. The performance mode cannot be
1110
+ # changed.
1111
+ #
1112
+ # * **Throughput mode** - The destination file system's throughput mode
1113
+ # matches that of the source file system. After the file system is
1114
+ # created, you can modify the throughput mode.
1115
+ #
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.
1122
+ #
1123
+ # * **Automatic backups** - Automatic daily backups are enabled on the
1124
+ # destination file system. After the file system is created, you can
1125
+ # change this setting.
1126
+ #
1127
+ # For more information, see [Amazon EFS replication][1] in the *Amazon
1128
+ # EFS User Guide*.
1129
+ #
1130
+ #
1131
+ #
1132
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html
1133
+ # [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
1135
+ #
1136
+ # @option params [required, String] :source_file_system_id
1137
+ # Specifies the Amazon EFS file system that you want to replicate. This
1138
+ # file system cannot already be a source or destination file system in
1139
+ # another replication configuration.
1140
+ #
1141
+ # @option params [required, Array<Types::DestinationToCreate>] :destinations
1142
+ # An array of destination configuration objects. Only one destination
1143
+ # configuration object is supported.
1144
+ #
1145
+ # @return [Types::ReplicationConfigurationDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1146
+ #
1147
+ # * {Types::ReplicationConfigurationDescription#source_file_system_id #source_file_system_id} => String
1148
+ # * {Types::ReplicationConfigurationDescription#source_file_system_region #source_file_system_region} => String
1149
+ # * {Types::ReplicationConfigurationDescription#source_file_system_arn #source_file_system_arn} => String
1150
+ # * {Types::ReplicationConfigurationDescription#original_source_file_system_arn #original_source_file_system_arn} => String
1151
+ # * {Types::ReplicationConfigurationDescription#creation_time #creation_time} => Time
1152
+ # * {Types::ReplicationConfigurationDescription#destinations #destinations} => Array&lt;Types::Destination&gt;
1153
+ #
1154
+ # @example Request syntax with placeholder values
1155
+ #
1156
+ # resp = client.create_replication_configuration({
1157
+ # source_file_system_id: "FileSystemId", # required
1158
+ # destinations: [ # required
1159
+ # {
1160
+ # region: "RegionName",
1161
+ # availability_zone_name: "AvailabilityZoneName",
1162
+ # kms_key_id: "KmsKeyId",
1163
+ # },
1164
+ # ],
1165
+ # })
1166
+ #
1167
+ # @example Response structure
1168
+ #
1169
+ # resp.source_file_system_id #=> String
1170
+ # resp.source_file_system_region #=> String
1171
+ # resp.source_file_system_arn #=> String
1172
+ # resp.original_source_file_system_arn #=> String
1173
+ # resp.creation_time #=> Time
1174
+ # resp.destinations #=> Array
1175
+ # resp.destinations[0].status #=> String, one of "ENABLED", "ENABLING", "DELETING", "ERROR", "PAUSED", "PAUSING"
1176
+ # resp.destinations[0].file_system_id #=> String
1177
+ # resp.destinations[0].region #=> String
1178
+ # resp.destinations[0].last_replicated_timestamp #=> Time
1179
+ #
1180
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateReplicationConfiguration AWS API Documentation
1181
+ #
1182
+ # @overload create_replication_configuration(params = {})
1183
+ # @param [Hash] params ({})
1184
+ def create_replication_configuration(params = {}, options = {})
1185
+ req = build_request(:create_replication_configuration, params)
1186
+ req.send_request(options)
1187
+ end
1188
+
1189
+ # <note markdown="1"> DEPRECATED - `CreateTags` is deprecated and not maintained. To create
1190
+ # tags for EFS resources, use the API action.
989
1191
  #
990
1192
  # </note>
991
1193
  #
@@ -1077,6 +1279,16 @@ module Aws::EFS
1077
1279
  # Upon return, the file system no longer exists and you can't access
1078
1280
  # any contents of the deleted file system.
1079
1281
  #
1282
+ # You need to manually delete mount targets attached to a file system
1283
+ # before you can delete an EFS file system. This step is performed for
1284
+ # you when you use the Amazon Web Services console to delete a file
1285
+ # system.
1286
+ #
1287
+ # <note markdown="1"> You cannot delete a file system that is part of an EFS Replication
1288
+ # configuration. You need to delete the replication configuration first.
1289
+ #
1290
+ # </note>
1291
+ #
1080
1292
  # You can't delete a file system that is in use. That is, if the file
1081
1293
  # system has any mount targets, you must first delete them. For more
1082
1294
  # information, see DescribeMountTargets and DeleteMountTarget.
@@ -1217,8 +1429,34 @@ module Aws::EFS
1217
1429
  req.send_request(options)
1218
1430
  end
1219
1431
 
1220
- # <note markdown="1"> DEPRECATED - DeleteTags is deprecated and not maintained. Please use
1221
- # the API action to remove tags from EFS resources.
1432
+ # Deletes an existing replication configuration. Deleting a replication
1433
+ # 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`.
1437
+ #
1438
+ # @option params [required, String] :source_file_system_id
1439
+ # The ID of the source file system in the replication configuration.
1440
+ #
1441
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1442
+ #
1443
+ # @example Request syntax with placeholder values
1444
+ #
1445
+ # resp = client.delete_replication_configuration({
1446
+ # source_file_system_id: "FileSystemId", # required
1447
+ # })
1448
+ #
1449
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration AWS API Documentation
1450
+ #
1451
+ # @overload delete_replication_configuration(params = {})
1452
+ # @param [Hash] params ({})
1453
+ def delete_replication_configuration(params = {}, options = {})
1454
+ req = build_request(:delete_replication_configuration, params)
1455
+ req.send_request(options)
1456
+ end
1457
+
1458
+ # <note markdown="1"> DEPRECATED - `DeleteTags` is deprecated and not maintained. To remove
1459
+ # tags from EFS resources, use the API action.
1222
1460
  #
1223
1461
  # </note>
1224
1462
  #
@@ -1348,8 +1586,7 @@ module Aws::EFS
1348
1586
 
1349
1587
  # Returns the account preferences settings for the Amazon Web Services
1350
1588
  # account associated with the user making the request, in the current
1351
- # Amazon Web Services Region. For more information, see [Managing Amazon
1352
- # EFS resource IDs](efs/latest/ug/manage-efs-resource-ids.html).
1589
+ # Amazon Web Services Region.
1353
1590
  #
1354
1591
  # @option params [String] :next_token
1355
1592
  # (Optional) You can use `NextToken` in a subsequent request to fetch
@@ -1459,11 +1696,11 @@ module Aws::EFS
1459
1696
  #
1460
1697
  # When retrieving all file system descriptions, you can optionally
1461
1698
  # specify the `MaxItems` parameter to limit the number of descriptions
1462
- # in a response. Currently, this number is automatically set to 10. If
1463
- # more file system descriptions remain, Amazon EFS returns a
1464
- # `NextMarker`, an opaque token, in the response. In this case, you
1465
- # should send a subsequent request with the `Marker` request parameter
1466
- # set to the value of `NextMarker`.
1699
+ # in a response. This number is automatically set to 100. If more file
1700
+ # system descriptions remain, Amazon EFS returns a `NextMarker`, an
1701
+ # opaque token, in the response. In this case, you should send a
1702
+ # subsequent request with the `Marker` request parameter set to the
1703
+ # value of `NextMarker`.
1467
1704
  #
1468
1705
  # To retrieve a list of your file system descriptions, this operation is
1469
1706
  # used in an iterative process, where `DescribeFileSystems` is called
@@ -1567,7 +1804,7 @@ module Aws::EFS
1567
1804
  # resp.file_systems[0].performance_mode #=> String, one of "generalPurpose", "maxIO"
1568
1805
  # resp.file_systems[0].encrypted #=> Boolean
1569
1806
  # resp.file_systems[0].kms_key_id #=> String
1570
- # resp.file_systems[0].throughput_mode #=> String, one of "bursting", "provisioned"
1807
+ # resp.file_systems[0].throughput_mode #=> String, one of "bursting", "provisioned", "elastic"
1571
1808
  # resp.file_systems[0].provisioned_throughput_in_mibps #=> Float
1572
1809
  # resp.file_systems[0].availability_zone_name #=> String
1573
1810
  # resp.file_systems[0].availability_zone_id #=> String
@@ -1592,7 +1829,7 @@ module Aws::EFS
1592
1829
  # `LifecycleConfiguration` object, the call returns an empty array in
1593
1830
  # the response.
1594
1831
  #
1595
- # When EFS Intelligent Tiering is enabled,
1832
+ # When EFS Intelligent-Tiering is enabled,
1596
1833
  # `TransitionToPrimaryStorageClass` has a value of `AFTER_1_ACCESS`.
1597
1834
  #
1598
1835
  # This operation requires permissions for the
@@ -1634,7 +1871,7 @@ module Aws::EFS
1634
1871
  # @example Response structure
1635
1872
  #
1636
1873
  # resp.lifecycle_policies #=> Array
1637
- # 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"
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"
1638
1875
  # resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
1639
1876
  #
1640
1877
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration AWS API Documentation
@@ -1805,8 +2042,63 @@ module Aws::EFS
1805
2042
  req.send_request(options)
1806
2043
  end
1807
2044
 
1808
- # <note markdown="1"> DEPRECATED - The DeleteTags action is deprecated and not maintained.
1809
- # Please use the API action to remove tags from EFS resources.
2045
+ # Retrieves the replication configuration for a specific file system. If
2046
+ # a file system is not specified, all of the replication configurations
2047
+ # for the Amazon Web Services account in an Amazon Web Services Region
2048
+ # are retrieved.
2049
+ #
2050
+ # @option params [String] :file_system_id
2051
+ # You can retrieve the replication configuration for a specific file
2052
+ # system by providing its file system ID.
2053
+ #
2054
+ # @option params [String] :next_token
2055
+ # `NextToken` is present if the response is paginated. You can use
2056
+ # `NextToken` in a subsequent request to fetch the next page of output.
2057
+ #
2058
+ # @option params [Integer] :max_results
2059
+ # (Optional) To limit the number of objects returned in a response, you
2060
+ # can specify the `MaxItems` parameter. The default value is 100.
2061
+ #
2062
+ # @return [Types::DescribeReplicationConfigurationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2063
+ #
2064
+ # * {Types::DescribeReplicationConfigurationsResponse#replications #replications} => Array&lt;Types::ReplicationConfigurationDescription&gt;
2065
+ # * {Types::DescribeReplicationConfigurationsResponse#next_token #next_token} => String
2066
+ #
2067
+ # @example Request syntax with placeholder values
2068
+ #
2069
+ # resp = client.describe_replication_configurations({
2070
+ # file_system_id: "FileSystemId",
2071
+ # next_token: "Token",
2072
+ # max_results: 1,
2073
+ # })
2074
+ #
2075
+ # @example Response structure
2076
+ #
2077
+ # resp.replications #=> Array
2078
+ # resp.replications[0].source_file_system_id #=> String
2079
+ # resp.replications[0].source_file_system_region #=> String
2080
+ # resp.replications[0].source_file_system_arn #=> String
2081
+ # resp.replications[0].original_source_file_system_arn #=> String
2082
+ # resp.replications[0].creation_time #=> Time
2083
+ # resp.replications[0].destinations #=> Array
2084
+ # resp.replications[0].destinations[0].status #=> String, one of "ENABLED", "ENABLING", "DELETING", "ERROR", "PAUSED", "PAUSING"
2085
+ # resp.replications[0].destinations[0].file_system_id #=> String
2086
+ # resp.replications[0].destinations[0].region #=> String
2087
+ # resp.replications[0].destinations[0].last_replicated_timestamp #=> Time
2088
+ # resp.next_token #=> String
2089
+ #
2090
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations AWS API Documentation
2091
+ #
2092
+ # @overload describe_replication_configurations(params = {})
2093
+ # @param [Hash] params ({})
2094
+ def describe_replication_configurations(params = {}, options = {})
2095
+ req = build_request(:describe_replication_configurations, params)
2096
+ req.send_request(options)
2097
+ end
2098
+
2099
+ # <note markdown="1"> DEPRECATED - The `DescribeTags` action is deprecated and not
2100
+ # maintained. To view tags associated with EFS resources, use the
2101
+ # `ListTagsForResource` API action.
1810
2102
  #
1811
2103
  # </note>
1812
2104
  #
@@ -2000,7 +2292,7 @@ module Aws::EFS
2000
2292
  # <note markdown="1"> Starting in October, 2021, you will receive an error if you try to set
2001
2293
  # the account preference to use the short 8 character format resource
2002
2294
  # ID. Contact Amazon Web Services support if you receive an error and
2003
- # need to use short IDs for file system and mount target resources.
2295
+ # must use short IDs for file system and mount target resources.
2004
2296
  #
2005
2297
  # </note>
2006
2298
  #
@@ -2015,7 +2307,7 @@ module Aws::EFS
2015
2307
  #
2016
2308
  # <note markdown="1"> Starting in October, 2021, you will receive an error when setting the
2017
2309
  # account preference to `SHORT_ID`. Contact Amazon Web Services support
2018
- # if you receive an error and need to use short IDs for file system and
2310
+ # if you receive an error and must use short IDs for file system and
2019
2311
  # mount target resources.
2020
2312
  #
2021
2313
  # </note>
@@ -2115,15 +2407,15 @@ module Aws::EFS
2115
2407
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/access-control-overview.html#access-control-manage-access-intro-resource-policies
2116
2408
  #
2117
2409
  # @option params [Boolean] :bypass_policy_lockout_safety_check
2118
- # (Optional) A flag to indicate whether to bypass the `FileSystemPolicy`
2119
- # lockout safety check. The policy lockout safety check determines
2120
- # whether the policy in the request will prevent the principal making
2121
- # the request will be locked out from making future
2122
- # `PutFileSystemPolicy` requests on the file system. Set
2410
+ # (Optional) A boolean that specifies whether or not to bypass the
2411
+ # `FileSystemPolicy` lockout safety check. The lockout safety check
2412
+ # determines whether the policy in the request will lock out, or
2413
+ # prevent, the IAM principal that is making the request from making
2414
+ # future `PutFileSystemPolicy` requests on this file system. Set
2123
2415
  # `BypassPolicyLockoutSafetyCheck` to `True` only when you intend to
2124
- # prevent the principal that is making the request from making a
2125
- # subsequent `PutFileSystemPolicy` request on the file system. The
2126
- # default value is False.
2416
+ # prevent the IAM principal that is making the request from making
2417
+ # subsequent `PutFileSystemPolicy` requests on this file system. The
2418
+ # default value is `False`.
2127
2419
  #
2128
2420
  # @return [Types::FileSystemPolicyDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2129
2421
  #
@@ -2152,13 +2444,25 @@ module Aws::EFS
2152
2444
  req.send_request(options)
2153
2445
  end
2154
2446
 
2155
- # Enables lifecycle management by creating a new
2156
- # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
2157
- # defines when files in an Amazon EFS file system are automatically
2158
- # transitioned to the lower-cost EFS Infrequent Access (IA) storage
2159
- # class. To enable EFS Intelligent Tiering, set the value of
2160
- # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`. For more
2161
- # information, see [EFS Lifecycle Management][1].
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:
2450
+ #
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.
2454
+ #
2455
+ # To enable EFS Lifecycle management, set the value of
2456
+ # `TransitionToIA` to one of the available options.
2457
+ #
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).
2461
+ #
2462
+ # To enable EFS Intelligent-Tiering, set the value of
2463
+ # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`.
2464
+ #
2465
+ # For more information, see [EFS Lifecycle Management][1].
2162
2466
  #
2163
2467
  # Each Amazon EFS file system supports one lifecycle configuration,
2164
2468
  # which applies to all files in the file system. If a
@@ -2166,20 +2470,24 @@ module Aws::EFS
2166
2470
  # system, a `PutLifecycleConfiguration` call modifies the existing
2167
2471
  # configuration. A `PutLifecycleConfiguration` call with an empty
2168
2472
  # `LifecyclePolicies` array in the request body deletes any existing
2169
- # `LifecycleConfiguration` and turns off lifecycle management for the
2170
- # file system.
2473
+ # `LifecycleConfiguration` and turns off lifecycle management and EFS
2474
+ # Intelligent-Tiering for the file system.
2171
2475
  #
2172
2476
  # In the request, specify the following:
2173
2477
  #
2174
2478
  # * The ID for the file system for which you are enabling, disabling, or
2175
- # modifying lifecycle management.
2479
+ # modifying lifecycle management and EFS Intelligent-Tiering.
2176
2480
  #
2177
2481
  # * A `LifecyclePolicies` array of `LifecyclePolicy` objects that define
2178
- # when files are moved to the IA storage class. Amazon EFS requires
2179
- # that each `LifecyclePolicy` object have only have a single
2180
- # transition, so the `LifecyclePolicies` array needs to be structured
2181
- # with separate `LifecyclePolicy` objects. See the example requests in
2182
- # the following section for more information.
2482
+ # when files are moved into IA storage, and when they are moved back
2483
+ # to Standard storage.
2484
+ #
2485
+ # <note markdown="1"> Amazon EFS requires that each `LifecyclePolicy` object have only
2486
+ # have a single transition, so the `LifecyclePolicies` array needs to
2487
+ # be structured with separate `LifecyclePolicy` objects. See the
2488
+ # example requests in the following section for more information.
2489
+ #
2490
+ # </note>
2183
2491
  #
2184
2492
  # This operation requires permissions for the
2185
2493
  # `elasticfilesystem:PutLifecycleConfiguration` operation.
@@ -2199,7 +2507,7 @@ module Aws::EFS
2199
2507
  # @option params [required, Array<Types::LifecyclePolicy>] :lifecycle_policies
2200
2508
  # An array of `LifecyclePolicy` objects that define the file system's
2201
2509
  # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
2202
- # informs EFS lifecycle management and intelligent tiering of the
2510
+ # informs EFS lifecycle management and EFS Intelligent-Tiering of the
2203
2511
  # following:
2204
2512
  #
2205
2513
  # * When to move files in the file system from primary storage to the IA
@@ -2210,8 +2518,8 @@ module Aws::EFS
2210
2518
  # <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
2211
2519
  # `PutLifecycleConfiguration` API action, Amazon EFS requires that each
2212
2520
  # `LifecyclePolicy` object have only a single transition. This means
2213
- # that in a request body, `LifecyclePolicies` needs to be structured as
2214
- # an array of `LifecyclePolicy` objects, one object for each transition,
2521
+ # that in a request body, `LifecyclePolicies` must be structured as an
2522
+ # array of `LifecyclePolicy` objects, one object for each transition,
2215
2523
  # `TransitionToIA`, `TransitionToPrimaryStorageClass`. See the example
2216
2524
  # requests in the following section for more information.
2217
2525
  #
@@ -2252,7 +2560,7 @@ module Aws::EFS
2252
2560
  # file_system_id: "FileSystemId", # required
2253
2561
  # lifecycle_policies: [ # required
2254
2562
  # {
2255
- # transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS
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
2256
2564
  # transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
2257
2565
  # },
2258
2566
  # ],
@@ -2261,7 +2569,7 @@ module Aws::EFS
2261
2569
  # @example Response structure
2262
2570
  #
2263
2571
  # resp.lifecycle_policies #=> Array
2264
- # 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"
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"
2265
2573
  # resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
2266
2574
  #
2267
2575
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutLifecycleConfiguration AWS API Documentation
@@ -2354,11 +2662,17 @@ module Aws::EFS
2354
2662
  # `ProvisionedThroughputInMibps`.
2355
2663
  #
2356
2664
  # @option params [Float] :provisioned_throughput_in_mibps
2357
- # (Optional) Sets the amount of provisioned throughput, in MiB/s, for
2358
- # the file system. Valid values are 1-1024. If you are changing the
2359
- # throughput mode to provisioned, you must also provide the amount of
2360
- # provisioned throughput. Required if `ThroughputMode` is changed to
2361
- # `provisioned` on update.
2665
+ # (Optional) The throughput, measured in mebibytes per second (MiBps),
2666
+ # that you want to provision for a file system that you're creating.
2667
+ # Required if `ThroughputMode` is set to `provisioned`. Valid values are
2668
+ # 1-3414 MiBps, with the upper limit depending on Region. To increase
2669
+ # this limit, contact Amazon Web Services Support. For more information,
2670
+ # see [Amazon EFS quotas that you can increase][1] in the *Amazon EFS
2671
+ # User Guide*.
2672
+ #
2673
+ #
2674
+ #
2675
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits
2362
2676
  #
2363
2677
  # @return [Types::FileSystemDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2364
2678
  #
@@ -2384,7 +2698,7 @@ module Aws::EFS
2384
2698
  #
2385
2699
  # resp = client.update_file_system({
2386
2700
  # file_system_id: "FileSystemId", # required
2387
- # throughput_mode: "bursting", # accepts bursting, provisioned
2701
+ # throughput_mode: "bursting", # accepts bursting, provisioned, elastic
2388
2702
  # provisioned_throughput_in_mibps: 1.0,
2389
2703
  # })
2390
2704
  #
@@ -2405,7 +2719,7 @@ module Aws::EFS
2405
2719
  # resp.performance_mode #=> String, one of "generalPurpose", "maxIO"
2406
2720
  # resp.encrypted #=> Boolean
2407
2721
  # resp.kms_key_id #=> String
2408
- # resp.throughput_mode #=> String, one of "bursting", "provisioned"
2722
+ # resp.throughput_mode #=> String, one of "bursting", "provisioned", "elastic"
2409
2723
  # resp.provisioned_throughput_in_mibps #=> Float
2410
2724
  # resp.availability_zone_name #=> String
2411
2725
  # resp.availability_zone_id #=> String
@@ -2435,7 +2749,7 @@ module Aws::EFS
2435
2749
  params: params,
2436
2750
  config: config)
2437
2751
  context[:gem_name] = 'aws-sdk-efs'
2438
- context[:gem_version] = '1.49.0'
2752
+ context[:gem_version] = '1.67.0'
2439
2753
  Seahorse::Client::Request.new(handlers, context)
2440
2754
  end
2441
2755