aws-sdk-efs 1.49.0 → 1.67.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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