aws-sdk-efs 1.53.0 → 1.54.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: 6bbfd58b3e13a4622f8cce9d4c090d7991f3f7b04eba19134912d778b1a20255
4
- data.tar.gz: e53180a9d801c1beacb3b14ecaf29863ba58d17dae000ceb4a08d0923c6459aa
3
+ metadata.gz: 0ef6ac1e47de89832b397bbab560340ad0dd631adf204695221372bff994317f
4
+ data.tar.gz: a8ab449ae2eb59eb0d07b63db2a213eb5e60bfa6318b497fb2d709941b3299db
5
5
  SHA512:
6
- metadata.gz: bc9b8b47e98f9752dfbaabf80ccfcfef3081dba3e31fb7690876d77297e8b40a5a06454b002b58d182bcd7ea5214d95fee675e639be8d7cd49307fc54c091b42
7
- data.tar.gz: ba2130657d4ee749caac8c9cbdd921eeceffe8442981cb668d04e5c5759e038940d8ce86c8d781422fe159df06780b4613f68b6f1527644d91036261be319710
6
+ metadata.gz: 20f5e34a95284f57db2f15e4a27fb8ac301933a1f58d3ffe36dac15c8b1b5f36a913b95018a402e95a95dcb1ea064739944f02aa0c6af89eed676bec69788827
7
+ data.tar.gz: dba13f876a87dde135787deedde5d085ef2f796aabbedf9d125f911c4982c4deaea3e8adad2a188a051a2f8a7ff158ae4b95e6ca6f40ab420d2ced499b8d1b78
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.54.0 (2022-04-12)
5
+ ------------------
6
+
7
+ * Feature - Amazon EFS adds support for a ThrottlingException when using the CreateAccessPoint API if the account is nearing the AccessPoint limit(120).
8
+
4
9
  1.53.0 (2022-02-24)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.53.0
1
+ 1.54.0
@@ -358,8 +358,8 @@ module Aws::EFS
358
358
  # user and group override any identity information provided by the NFS
359
359
  # client. The file system path is exposed as the access point's root
360
360
  # directory. Applications using the access point can only access data in
361
- # its own directory and below. To learn more, see [Mounting a file
362
- # system using EFS access points][1].
361
+ # the application's own directory and any subdirectories. To learn
362
+ # more, see [Mounting a file system using EFS access points][1].
363
363
  #
364
364
  # This operation requires permissions for the
365
365
  # `elasticfilesystem:CreateAccessPoint` action.
@@ -400,7 +400,7 @@ module Aws::EFS
400
400
  # access the root directory and below. If the `RootDirectory` >
401
401
  # `Path` specified does not exist, EFS creates it and applies the
402
402
  # `CreationInfo` settings when a client connects to an access point.
403
- # When specifying a `RootDirectory`, you need to provide the `Path`, and
403
+ # When specifying a `RootDirectory`, you must provide the `Path`, and
404
404
  # the `CreationInfo`.
405
405
  #
406
406
  # Amazon EFS creates a root directory only if you have provided the
@@ -575,7 +575,7 @@ module Aws::EFS
575
575
  #
576
576
  # @option params [String] :kms_key_id
577
577
  # The ID of the KMS key that you want to use to protect the encrypted
578
- # file system. This parameter is only required if you want to use a
578
+ # file system. This parameter is required only if you want to use a
579
579
  # non-default KMS key. If this parameter is not specified, the default
580
580
  # KMS key for Amazon EFS is used. You can specify a KMS key ID using the
581
581
  # following formats:
@@ -999,61 +999,67 @@ module Aws::EFS
999
999
 
1000
1000
  # Creates a replication configuration that replicates an existing EFS
1001
1001
  # file system to a new, read-only file system. For more information, see
1002
- # [Amazon EFS replication][1]. The replication configuration specifies
1003
- # the following:
1002
+ # [Amazon EFS replication][1] in the *Amazon EFS User Guide*. The
1003
+ # replication configuration specifies the following:
1004
1004
  #
1005
- # * **Source file system** - an existing EFS file system that you want
1005
+ # * **Source file system** - An existing EFS file system that you want
1006
1006
  # replicated. The source file system cannot be a destination file
1007
1007
  # system in an existing replication configuration.
1008
1008
  #
1009
- # * **Destination file system configuration** - the configuration of the
1009
+ # * **Destination file system configuration** - The configuration of the
1010
1010
  # destination file system to which the source file system will be
1011
1011
  # replicated. There can only be one destination file system in a
1012
- # replication configuration.
1012
+ # replication configuration. The destination file system configuration
1013
+ # consists of the following properties:
1013
1014
  #
1014
1015
  # * **Amazon Web Services Region** - The Amazon Web Services Region in
1015
- # which the destination file system is created. EFS Replication is
1016
- # available in all Amazon Web Services Region that Amazon EFS is
1017
- # available in, except the following regions: Asia Pacific (Hong
1018
- # Kong) Europe (Milan), Middle East (Bahrain), Africa (Cape Town),
1019
- # and Asia Pacific (Jakarta).
1020
- #
1021
- # * **Availability zone** - If you want the destination file system to
1022
- # use One Zone availability and durability, you must specify the
1016
+ # which the destination file system is created. Amazon EFS
1017
+ # replication is available in all Amazon Web Services Regions that
1018
+ # Amazon EFS is available in, except Africa (Cape Town), Asia
1019
+ # Pacific (Hong Kong), Asia Pacific (Jakarta), Europe (Milan), and
1020
+ # Middle East (Bahrain).
1021
+ #
1022
+ # * **Availability Zone** - If you want the destination file system to
1023
+ # use EFS One Zone availability and durability, you must specify the
1023
1024
  # Availability Zone to create the file system in. For more
1024
1025
  # information about EFS storage classes, see [ Amazon EFS storage
1025
1026
  # classes][2] in the *Amazon EFS User Guide*.
1026
1027
  #
1027
1028
  # * **Encryption** - All destination file systems are created with
1028
- # encryption at rest enabled. You can specify the KMS key that is
1029
- # used to encrypt the destination file system. Your service-managed
1030
- # KMS key for Amazon EFS is used if you don't specify a KMS key.
1031
- # You cannot change this after the file system is created.
1029
+ # encryption at rest enabled. You can specify the Key Management
1030
+ # Service (KMS) key that is used to encrypt the destination file
1031
+ # system. If you don't specify a KMS key, your service-managed KMS
1032
+ # key for Amazon EFS is used.
1033
+ #
1034
+ # <note markdown="1"> After the file system is created, you cannot change the KMS key.
1035
+ #
1036
+ # </note>
1032
1037
  #
1033
1038
  # The following properties are set by default:
1034
1039
  #
1035
1040
  # * **Performance mode** - The destination file system's performance
1036
- # mode will match that of the source file system, unless the
1037
- # destination file system uses One Zone storage. In that case, the
1038
- # *General Purpose* performance mode is used. The Performance mode
1039
- # cannot be changed.
1041
+ # mode matches that of the source file system, unless the destination
1042
+ # file system uses EFS One Zone storage. In that case, the General
1043
+ # Purpose performance mode is used. The performance mode cannot be
1044
+ # changed.
1040
1045
  #
1041
- # * **Throughput mode** - The destination file system use the Bursting
1042
- # throughput mode by default. You can modify the throughput mode once
1043
- # the file system is created.
1046
+ # * **Throughput mode** - The destination file system uses the Bursting
1047
+ # Throughput mode by default. After the file system is created, you
1048
+ # can modify the throughput mode.
1044
1049
  #
1045
1050
  # The following properties are turned off by default:
1046
1051
  #
1047
- # * **Lifecycle management** - EFS lifecycle management and intelligent
1048
- # tiering are not enabled on the destination file system. You can
1049
- # enable EFS lifecycle management and intelligent tiering after the
1050
- # destination file system is created.
1052
+ # * **Lifecycle management** - EFS lifecycle management and EFS
1053
+ # Intelligent-Tiering are not enabled on the destination file system.
1054
+ # After the destination file system is created, you can enable EFS
1055
+ # lifecycle management and EFS Intelligent-Tiering.
1051
1056
  #
1052
1057
  # * **Automatic backups** - Automatic daily backups not enabled on the
1053
- # destination file system. You can change this setting after the file
1054
- # system is created.
1058
+ # destination file system. After the file system is created, you can
1059
+ # change this setting.
1055
1060
  #
1056
- # For more information, see [Amazon EFS replication][1].
1061
+ # For more information, see [Amazon EFS replication][1] in the *Amazon
1062
+ # EFS User Guide*.
1057
1063
  #
1058
1064
  #
1059
1065
  #
@@ -1113,8 +1119,8 @@ module Aws::EFS
1113
1119
  req.send_request(options)
1114
1120
  end
1115
1121
 
1116
- # <note markdown="1"> DEPRECATED - CreateTags is deprecated and not maintained. Please use
1117
- # the API action to create tags for EFS resources.
1122
+ # <note markdown="1"> DEPRECATED - `CreateTags` is deprecated and not maintained. To create
1123
+ # tags for EFS resources, use the API action.
1118
1124
  #
1119
1125
  # </note>
1120
1126
  #
@@ -1206,6 +1212,16 @@ module Aws::EFS
1206
1212
  # Upon return, the file system no longer exists and you can't access
1207
1213
  # any contents of the deleted file system.
1208
1214
  #
1215
+ # You need to manually delete mount targets attached to a file system
1216
+ # before you can delete an EFS file system. This step is performed for
1217
+ # you when you use the Amazon Web Services console to delete a file
1218
+ # system.
1219
+ #
1220
+ # <note markdown="1"> You cannot delete a file system that is part of an EFS Replication
1221
+ # configuration. You need to delete the replication configuration first.
1222
+ #
1223
+ # </note>
1224
+ #
1209
1225
  # You can't delete a file system that is in use. That is, if the file
1210
1226
  # system has any mount targets, you must first delete them. For more
1211
1227
  # information, see DescribeMountTargets and DeleteMountTarget.
@@ -1349,8 +1365,10 @@ module Aws::EFS
1349
1365
  # Deletes an existing replication configuration. To delete a replication
1350
1366
  # configuration, you must make the request from the Amazon Web Services
1351
1367
  # Region in which the destination file system is located. Deleting a
1352
- # replication configuration ends the replication process. You can write
1353
- # to the destination file system once it's status becomes `Writeable`.
1368
+ # replication configuration ends the replication process. After a
1369
+ # replication configuration is deleted, the destination file system is
1370
+ # no longer read-only. You can write to the destination file system
1371
+ # after its status becomes `Writeable`.
1354
1372
  #
1355
1373
  # @option params [required, String] :source_file_system_id
1356
1374
  # The ID of the source file system in the replication configuration.
@@ -1372,8 +1390,8 @@ module Aws::EFS
1372
1390
  req.send_request(options)
1373
1391
  end
1374
1392
 
1375
- # <note markdown="1"> DEPRECATED - DeleteTags is deprecated and not maintained. Please use
1376
- # the API action to remove tags from EFS resources.
1393
+ # <note markdown="1"> DEPRECATED - `DeleteTags` is deprecated and not maintained. To remove
1394
+ # tags from EFS resources, use the API action.
1377
1395
  #
1378
1396
  # </note>
1379
1397
  #
@@ -1747,7 +1765,7 @@ module Aws::EFS
1747
1765
  # `LifecycleConfiguration` object, the call returns an empty array in
1748
1766
  # the response.
1749
1767
  #
1750
- # When EFS Intelligent Tiering is enabled,
1768
+ # When EFS Intelligent-Tiering is enabled,
1751
1769
  # `TransitionToPrimaryStorageClass` has a value of `AFTER_1_ACCESS`.
1752
1770
  #
1753
1771
  # This operation requires permissions for the
@@ -1960,22 +1978,22 @@ module Aws::EFS
1960
1978
  req.send_request(options)
1961
1979
  end
1962
1980
 
1963
- # Retrieves the replication configurations for either a specific file
1964
- # system, or all configurations for the Amazon Web Services account in
1965
- # an Amazon Web Services Region if a file system is not specified.
1981
+ # Retrieves the replication configuration for a specific file system. If
1982
+ # a file system is not specified, all of the replication configurations
1983
+ # for the Amazon Web Services account in an Amazon Web Services Region
1984
+ # are retrieved.
1966
1985
  #
1967
1986
  # @option params [String] :file_system_id
1968
- # You can retrieve replication configurations for a specific file system
1969
- # by providing a file system ID.
1987
+ # You can retrieve the replication configuration for a specific file
1988
+ # system by providing its file system ID.
1970
1989
  #
1971
1990
  # @option params [String] :next_token
1972
1991
  # `NextToken` is present if the response is paginated. You can use
1973
- # `NextMarker` in a subsequent request to fetch the next page of output.
1992
+ # `NextToken` in a subsequent request to fetch the next page of output.
1974
1993
  #
1975
1994
  # @option params [Integer] :max_results
1976
- # (Optional) You can optionally specify the `MaxItems` parameter to
1977
- # limit the number of objects returned in a response. The default value
1978
- # is 100.
1995
+ # (Optional) To limit the number of objects returned in a response, you
1996
+ # can specify the `MaxItems` parameter. The default value is 100.
1979
1997
  #
1980
1998
  # @return [Types::DescribeReplicationConfigurationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1981
1999
  #
@@ -2014,8 +2032,9 @@ module Aws::EFS
2014
2032
  req.send_request(options)
2015
2033
  end
2016
2034
 
2017
- # <note markdown="1"> DEPRECATED - The DeleteTags action is deprecated and not maintained.
2018
- # Please use the API action to remove tags from EFS resources.
2035
+ # <note markdown="1"> DEPRECATED - The `DescribeTags` action is deprecated and not
2036
+ # maintained. To view tags associated with EFS resources, use the
2037
+ # `ListTagsForResource` API action.
2019
2038
  #
2020
2039
  # </note>
2021
2040
  #
@@ -2209,7 +2228,7 @@ module Aws::EFS
2209
2228
  # <note markdown="1"> Starting in October, 2021, you will receive an error if you try to set
2210
2229
  # the account preference to use the short 8 character format resource
2211
2230
  # ID. Contact Amazon Web Services support if you receive an error and
2212
- # need to use short IDs for file system and mount target resources.
2231
+ # must use short IDs for file system and mount target resources.
2213
2232
  #
2214
2233
  # </note>
2215
2234
  #
@@ -2224,7 +2243,7 @@ module Aws::EFS
2224
2243
  #
2225
2244
  # <note markdown="1"> Starting in October, 2021, you will receive an error when setting the
2226
2245
  # account preference to `SHORT_ID`. Contact Amazon Web Services support
2227
- # if you receive an error and need to use short IDs for file system and
2246
+ # if you receive an error and must use short IDs for file system and
2228
2247
  # mount target resources.
2229
2248
  #
2230
2249
  # </note>
@@ -2324,15 +2343,15 @@ module Aws::EFS
2324
2343
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/access-control-overview.html#access-control-manage-access-intro-resource-policies
2325
2344
  #
2326
2345
  # @option params [Boolean] :bypass_policy_lockout_safety_check
2327
- # (Optional) A flag to indicate whether to bypass the `FileSystemPolicy`
2328
- # lockout safety check. The policy lockout safety check determines
2329
- # whether the policy in the request will prevent the principal making
2330
- # the request will be locked out from making future
2331
- # `PutFileSystemPolicy` requests on the file system. Set
2346
+ # (Optional) A boolean that specifies whether or not to bypass the
2347
+ # `FileSystemPolicy` lockout safety check. The lockout safety check
2348
+ # determines whether the policy in the request will lock out, or
2349
+ # prevent, the IAM principal that is making the request from making
2350
+ # future `PutFileSystemPolicy` requests on this file system. Set
2332
2351
  # `BypassPolicyLockoutSafetyCheck` to `True` only when you intend to
2333
- # prevent the principal that is making the request from making a
2334
- # subsequent `PutFileSystemPolicy` request on the file system. The
2335
- # default value is False.
2352
+ # prevent the IAM principal that is making the request from making
2353
+ # subsequent `PutFileSystemPolicy` requests on this file system. The
2354
+ # default value is `False`.
2336
2355
  #
2337
2356
  # @return [Types::FileSystemPolicyDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2338
2357
  #
@@ -2361,13 +2380,25 @@ module Aws::EFS
2361
2380
  req.send_request(options)
2362
2381
  end
2363
2382
 
2364
- # Enables lifecycle management by creating a new
2365
- # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
2366
- # defines when files in an Amazon EFS file system are automatically
2367
- # transitioned to the lower-cost EFS Infrequent Access (IA) storage
2368
- # class. To enable EFS Intelligent Tiering, set the value of
2369
- # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`. For more
2370
- # information, see [EFS Lifecycle Management][1].
2383
+ # Use this action to manage EFS lifecycle management and intelligent
2384
+ # tiering. A `LifecycleConfiguration` consists of one or more
2385
+ # `LifecyclePolicy` objects that define the following:
2386
+ #
2387
+ # * **EFS Lifecycle management** - When Amazon EFS automatically
2388
+ # transitions files in a file system into the lower-cost Infrequent
2389
+ # Access (IA) storage class.
2390
+ #
2391
+ # To enable EFS Lifecycle management, set the value of
2392
+ # `TransitionToIA` to one of the available options.
2393
+ #
2394
+ # * **EFS Intelligent tiering** - When Amazon EFS automatically
2395
+ # transitions files from IA back into the file system's primary
2396
+ # storage class (Standard or One Zone Standard.
2397
+ #
2398
+ # To enable EFS Intelligent Tiering, set the value of
2399
+ # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`.
2400
+ #
2401
+ # For more information, see [EFS Lifecycle Management][1].
2371
2402
  #
2372
2403
  # Each Amazon EFS file system supports one lifecycle configuration,
2373
2404
  # which applies to all files in the file system. If a
@@ -2375,20 +2406,24 @@ module Aws::EFS
2375
2406
  # system, a `PutLifecycleConfiguration` call modifies the existing
2376
2407
  # configuration. A `PutLifecycleConfiguration` call with an empty
2377
2408
  # `LifecyclePolicies` array in the request body deletes any existing
2378
- # `LifecycleConfiguration` and turns off lifecycle management for the
2379
- # file system.
2409
+ # `LifecycleConfiguration` and turns off lifecycle management and
2410
+ # intelligent tiering for the file system.
2380
2411
  #
2381
2412
  # In the request, specify the following:
2382
2413
  #
2383
2414
  # * The ID for the file system for which you are enabling, disabling, or
2384
- # modifying lifecycle management.
2415
+ # modifying lifecycle management and intelligent tiering.
2385
2416
  #
2386
2417
  # * A `LifecyclePolicies` array of `LifecyclePolicy` objects that define
2387
- # when files are moved to the IA storage class. Amazon EFS requires
2388
- # that each `LifecyclePolicy` object have only have a single
2389
- # transition, so the `LifecyclePolicies` array needs to be structured
2390
- # with separate `LifecyclePolicy` objects. See the example requests in
2391
- # the following section for more information.
2418
+ # when files are moved into IA storage, and when they are moved back
2419
+ # to Standard storage.
2420
+ #
2421
+ # <note markdown="1"> Amazon EFS requires that each `LifecyclePolicy` object have only
2422
+ # have a single transition, so the `LifecyclePolicies` array needs to
2423
+ # be structured with separate `LifecyclePolicy` objects. See the
2424
+ # example requests in the following section for more information.
2425
+ #
2426
+ # </note>
2392
2427
  #
2393
2428
  # This operation requires permissions for the
2394
2429
  # `elasticfilesystem:PutLifecycleConfiguration` operation.
@@ -2408,7 +2443,7 @@ module Aws::EFS
2408
2443
  # @option params [required, Array<Types::LifecyclePolicy>] :lifecycle_policies
2409
2444
  # An array of `LifecyclePolicy` objects that define the file system's
2410
2445
  # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
2411
- # informs EFS lifecycle management and intelligent tiering of the
2446
+ # informs EFS lifecycle management and EFS Intelligent-Tiering of the
2412
2447
  # following:
2413
2448
  #
2414
2449
  # * When to move files in the file system from primary storage to the IA
@@ -2419,8 +2454,8 @@ module Aws::EFS
2419
2454
  # <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
2420
2455
  # `PutLifecycleConfiguration` API action, Amazon EFS requires that each
2421
2456
  # `LifecyclePolicy` object have only a single transition. This means
2422
- # that in a request body, `LifecyclePolicies` needs to be structured as
2423
- # an array of `LifecyclePolicy` objects, one object for each transition,
2457
+ # that in a request body, `LifecyclePolicies` must be structured as an
2458
+ # array of `LifecyclePolicy` objects, one object for each transition,
2424
2459
  # `TransitionToIA`, `TransitionToPrimaryStorageClass`. See the example
2425
2460
  # requests in the following section for more information.
2426
2461
  #
@@ -2644,7 +2679,7 @@ module Aws::EFS
2644
2679
  params: params,
2645
2680
  config: config)
2646
2681
  context[:gem_name] = 'aws-sdk-efs'
2647
- context[:gem_version] = '1.53.0'
2682
+ context[:gem_version] = '1.54.0'
2648
2683
  Seahorse::Client::Request.new(handlers, context)
2649
2684
  end
2650
2685
 
@@ -148,6 +148,7 @@ module Aws::EFS
148
148
  TagResourceRequest = Shapes::StructureShape.new(name: 'TagResourceRequest')
149
149
  TagValue = Shapes::StringShape.new(name: 'TagValue')
150
150
  Tags = Shapes::ListShape.new(name: 'Tags')
151
+ ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
151
152
  ThroughputLimitExceeded = Shapes::StructureShape.new(name: 'ThroughputLimitExceeded')
152
153
  ThroughputMode = Shapes::StringShape.new(name: 'ThroughputMode')
153
154
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
@@ -557,6 +558,10 @@ module Aws::EFS
557
558
 
558
559
  Tags.member = Shapes::ShapeRef.new(shape: Tag)
559
560
 
561
+ ThrottlingException.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, location_name: "ErrorCode"))
562
+ ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
563
+ ThrottlingException.struct_class = Types::ThrottlingException
564
+
560
565
  ThroughputLimitExceeded.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, required: true, location_name: "ErrorCode"))
561
566
  ThroughputLimitExceeded.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
562
567
  ThroughputLimitExceeded.struct_class = Types::ThroughputLimitExceeded
@@ -611,6 +616,7 @@ module Aws::EFS
611
616
  o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
612
617
  o.errors << Shapes::ShapeRef.new(shape: FileSystemNotFound)
613
618
  o.errors << Shapes::ShapeRef.new(shape: AccessPointLimitExceeded)
619
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
614
620
  end)
615
621
 
616
622
  api.add_operation(:create_file_system, Seahorse::Model::Operation.new.tap do |o|
@@ -52,6 +52,7 @@ module Aws::EFS
52
52
  # * {SecurityGroupLimitExceeded}
53
53
  # * {SecurityGroupNotFound}
54
54
  # * {SubnetNotFound}
55
+ # * {ThrottlingException}
55
56
  # * {ThroughputLimitExceeded}
56
57
  # * {TooManyRequests}
57
58
  # * {UnsupportedAvailabilityZone}
@@ -573,6 +574,26 @@ module Aws::EFS
573
574
  end
574
575
  end
575
576
 
577
+ class ThrottlingException < ServiceError
578
+
579
+ # @param [Seahorse::Client::RequestContext] context
580
+ # @param [String] message
581
+ # @param [Aws::EFS::Types::ThrottlingException] data
582
+ def initialize(context, message, data = Aws::EmptyStructure.new)
583
+ super(context, message, data)
584
+ end
585
+
586
+ # @return [String]
587
+ def error_code
588
+ @data[:error_code]
589
+ end
590
+
591
+ # @return [String]
592
+ def message
593
+ @message || @data[:message]
594
+ end
595
+ end
596
+
576
597
  class ThroughputLimitExceeded < ServiceError
577
598
 
578
599
  # @param [Seahorse::Client::RequestContext] context
@@ -10,8 +10,8 @@
10
10
  module Aws::EFS
11
11
  module Types
12
12
 
13
- # Returned if the access point you are trying to create already exists,
14
- # with the creation token you provided in the request.
13
+ # Returned if the access point that you are trying to create already
14
+ # exists, with the creation token you provided in the request.
15
15
  #
16
16
  # @!attribute [rw] error_code
17
17
  # The error code is a string that uniquely identifies an error
@@ -109,7 +109,13 @@ module Aws::EFS
109
109
  end
110
110
 
111
111
  # Returned if the Amazon Web Services account has already created the
112
- # maximum number of access points allowed per file system.
112
+ # maximum number of access points allowed per file system. For more
113
+ # informaton, see
114
+ # [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region][1].
115
+ #
116
+ #
117
+ #
118
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region
113
119
  #
114
120
  # @!attribute [rw] error_code
115
121
  # The error code is a string that uniquely identifies an error
@@ -166,8 +172,8 @@ module Aws::EFS
166
172
 
167
173
  # Returned if the Availability Zone that was specified for a mount
168
174
  # target is different from the Availability Zone that was specified for
169
- # One Zone storage classes. For more information, see [Regional and One
170
- # Zone storage redundancy][1].
175
+ # One Zone storage. For more information, see [Regional and One Zone
176
+ # storage redundancy][1].
171
177
  #
172
178
  #
173
179
  #
@@ -223,7 +229,7 @@ module Aws::EFS
223
229
  # * <b> <code>ENABLING</code> </b> - EFS is turning on automatic
224
230
  # backups for the file system.
225
231
  #
226
- # * <b> <code>DISABLED</code> </b> - automatic back ups are turned off
232
+ # * <b> <code>DISABLED</code> </b> - Automatic back ups are turned off
227
233
  # for the file system.
228
234
  #
229
235
  # * <b> <code>DISABLING</code> </b> - EFS is turning off automatic
@@ -240,7 +246,7 @@ module Aws::EFS
240
246
 
241
247
  # @!attribute [rw] backup_policy
242
248
  # Describes the file system's backup policy, indicating whether
243
- # automatic backups are turned on or off..
249
+ # automatic backups are turned on or off.
244
250
  # @return [Types::BackupPolicy]
245
251
  #
246
252
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/BackupPolicyDescription AWS API Documentation
@@ -342,7 +348,7 @@ module Aws::EFS
342
348
  # point can only access the root directory and below. If the
343
349
  # `RootDirectory` &gt; `Path` specified does not exist, EFS creates it
344
350
  # and applies the `CreationInfo` settings when a client connects to an
345
- # access point. When specifying a `RootDirectory`, you need to provide
351
+ # access point. When specifying a `RootDirectory`, you must provide
346
352
  # the `Path`, and the `CreationInfo`.
347
353
  #
348
354
  # Amazon EFS creates a root directory only if you have provided the
@@ -418,7 +424,7 @@ module Aws::EFS
418
424
  #
419
425
  # @!attribute [rw] kms_key_id
420
426
  # The ID of the KMS key that you want to use to protect the encrypted
421
- # file system. This parameter is only required if you want to use a
427
+ # file system. This parameter is required only if you want to use a
422
428
  # non-default KMS key. If this parameter is not specified, the default
423
429
  # KMS key for Amazon EFS is used. You can specify a KMS key ID using
424
430
  # the following formats:
@@ -1213,20 +1219,19 @@ module Aws::EFS
1213
1219
  # }
1214
1220
  #
1215
1221
  # @!attribute [rw] file_system_id
1216
- # You can retrieve replication configurations for a specific file
1217
- # system by providing a file system ID.
1222
+ # You can retrieve the replication configuration for a specific file
1223
+ # system by providing its file system ID.
1218
1224
  # @return [String]
1219
1225
  #
1220
1226
  # @!attribute [rw] next_token
1221
1227
  # `NextToken` is present if the response is paginated. You can use
1222
- # `NextMarker` in a subsequent request to fetch the next page of
1228
+ # `NextToken` in a subsequent request to fetch the next page of
1223
1229
  # output.
1224
1230
  # @return [String]
1225
1231
  #
1226
1232
  # @!attribute [rw] max_results
1227
- # (Optional) You can optionally specify the `MaxItems` parameter to
1228
- # limit the number of objects returned in a response. The default
1229
- # value is 100.
1233
+ # (Optional) To limit the number of objects returned in a response,
1234
+ # you can specify the `MaxItems` parameter. The default value is 100.
1230
1235
  # @return [Integer]
1231
1236
  #
1232
1237
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeReplicationConfigurationsRequest AWS API Documentation
@@ -1240,7 +1245,7 @@ module Aws::EFS
1240
1245
  end
1241
1246
 
1242
1247
  # @!attribute [rw] replications
1243
- # The collection of replication configurations returned.
1248
+ # The collection of replication configurations that is returned.
1244
1249
  # @return [Array<Types::ReplicationConfigurationDescription>]
1245
1250
  #
1246
1251
  # @!attribute [rw] next_token
@@ -1324,7 +1329,11 @@ module Aws::EFS
1324
1329
  # configuration.
1325
1330
  #
1326
1331
  # @!attribute [rw] status
1327
- # Describes the status of the destination Amazon EFS file system.
1332
+ # Describes the status of the destination Amazon EFS file system. If
1333
+ # the status is `ERROR`, the destination file system in the
1334
+ # replication configuration is in a failed state and is unrecoverable.
1335
+ # To access the file system data, restore a backup of the failed file
1336
+ # system to a new file system.
1328
1337
  # @return [String]
1329
1338
  #
1330
1339
  # @!attribute [rw] file_system_id
@@ -1337,11 +1346,11 @@ module Aws::EFS
1337
1346
  # @return [String]
1338
1347
  #
1339
1348
  # @!attribute [rw] last_replicated_timestamp
1340
- # The time when the most recent sync successfully completed on the
1349
+ # The time when the most recent sync was successfully completed on the
1341
1350
  # destination file system. Any changes to data on the source file
1342
- # system that occurred prior to this time were successfully replicated
1343
- # to the destination file system. Any changes that occurred after this
1344
- # time might not be fully replicated.
1351
+ # system that occurred before this time have been successfully
1352
+ # replicated to the destination file system. Any changes that occurred
1353
+ # after this time might not be fully replicated.
1345
1354
  # @return [Time]
1346
1355
  #
1347
1356
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/Destination AWS API Documentation
@@ -1368,33 +1377,34 @@ module Aws::EFS
1368
1377
  # }
1369
1378
  #
1370
1379
  # @!attribute [rw] region
1371
- # To create a file system that uses regional storage, specify the
1380
+ # To create a file system that uses Regional storage, specify the
1372
1381
  # Amazon Web Services Region in which to create the destination file
1373
1382
  # system.
1374
1383
  # @return [String]
1375
1384
  #
1376
1385
  # @!attribute [rw] availability_zone_name
1377
- # To create a file system that uses One Zone storage, specify the name
1378
- # of the Availability Zone in which to create the destination file
1379
- # system.
1386
+ # To create a file system that uses EFS One Zone storage, specify the
1387
+ # name of the Availability Zone in which to create the destination
1388
+ # file system.
1380
1389
  # @return [String]
1381
1390
  #
1382
1391
  # @!attribute [rw] kms_key_id
1383
- # Specifies the KMS key you want to use to encrypt the destination
1384
- # file system. If you do not specify a KMS key, EFS uses your default
1385
- # KMS key for Amazon EFS, `/aws/elasticfilesystem`. This ID can be in
1386
- # one of the following formats:
1392
+ # Specifies the Key Management Service (KMS) key that you want to use
1393
+ # to encrypt the destination file system. If you do not specify a KMS
1394
+ # key, Amazon EFS uses your default KMS key for Amazon EFS,
1395
+ # `/aws/elasticfilesystem`. This ID can be in one of the following
1396
+ # formats:
1387
1397
  #
1388
- # * Key ID - A unique identifier of the key, for example
1398
+ # * Key ID - The unique identifier of the key, for example
1389
1399
  # `1234abcd-12ab-34cd-56ef-1234567890ab`.
1390
1400
  #
1391
- # * ARN - An Amazon Resource Name (ARN) for the key, for example
1401
+ # * ARN - The Amazon Resource Name (ARN) for the key, for example
1392
1402
  # `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
1393
1403
  #
1394
1404
  # * Key alias - A previously created display name for a key, for
1395
1405
  # example `alias/projectKey1`.
1396
1406
  #
1397
- # * Key alias ARN - An ARN for a key alias, for example
1407
+ # * Key alias ARN - The ARN for a key alias, for example
1398
1408
  # `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
1399
1409
  # @return [String]
1400
1410
  #
@@ -1775,8 +1785,8 @@ module Aws::EFS
1775
1785
  # throughput. This value might be returned when you try to create a file
1776
1786
  # system in provisioned throughput mode, when you attempt to increase
1777
1787
  # the provisioned throughput of an existing file system, or when you
1778
- # attempt to change an existing file system from bursting to provisioned
1779
- # throughput mode. Try again later.
1788
+ # attempt to change an existing file system from Bursting Throughput to
1789
+ # Provisioned Throughput mode. Try again later.
1780
1790
  #
1781
1791
  # @!attribute [rw] error_code
1782
1792
  # The error code is a string that uniquely identifies an error
@@ -1830,8 +1840,8 @@ module Aws::EFS
1830
1840
  include Aws::Structure
1831
1841
  end
1832
1842
 
1833
- # Returned if the `FileSystemPolicy` is is malformed or contains an
1834
- # error such as an invalid parameter value or a missing required
1843
+ # Returned if the `FileSystemPolicy` is malformed or contains an error
1844
+ # such as a parameter value that is not valid or a missing required
1835
1845
  # parameter. Returned in the case of a policy lockout safety check
1836
1846
  # error.
1837
1847
  #
@@ -1902,7 +1912,7 @@ module Aws::EFS
1902
1912
  end
1903
1913
 
1904
1914
  # Describes a policy used by EFS lifecycle management and EFS
1905
- # intelligent tiering that specifies when to transition files into and
1915
+ # Intelligent-Tiering that specifies when to transition files into and
1906
1916
  # out of the file system's Infrequent Access (IA) storage class. For
1907
1917
  # more information, see [EFS Intelligent‐Tiering and EFS Lifecycle
1908
1918
  # Management][1].
@@ -1910,8 +1920,8 @@ module Aws::EFS
1910
1920
  # <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
1911
1921
  # `PutLifecycleConfiguration` API action, Amazon EFS requires that each
1912
1922
  # `LifecyclePolicy` object have only a single transition. This means
1913
- # that in a request body, `LifecyclePolicies` needs to be structured as
1914
- # an array of `LifecyclePolicy` objects, one object for each transition,
1923
+ # that in a request body, `LifecyclePolicies` must be structured as an
1924
+ # array of `LifecyclePolicy` objects, one object for each transition,
1915
1925
  # `TransitionToIA`, `TransitionToPrimaryStorageClass`. For more
1916
1926
  # information, see the request examples in PutLifecycleConfiguration.
1917
1927
  #
@@ -2158,11 +2168,11 @@ module Aws::EFS
2158
2168
  end
2159
2169
 
2160
2170
  # The calling account has reached the limit for elastic network
2161
- # interfaces for the specific Amazon Web Services Region. The client
2162
- # should try to delete some elastic network interfaces or get the
2163
- # account limit raised. For more information, see [Amazon VPC Limits][1]
2164
- # in the <i>Amazon VPC User Guide </i> (see the Network interfaces per
2165
- # VPC entry in the table).
2171
+ # interfaces for the specific Amazon Web Services Region. Either delete
2172
+ # some network interfaces or request that the account quota be raised.
2173
+ # For more information, see [Amazon VPC Quotas][1] in the *Amazon VPC
2174
+ # User Guide* (see the **Network interfaces per Region** entry in the
2175
+ # **Network interfaces** table).
2166
2176
  #
2167
2177
  #
2168
2178
  #
@@ -2302,7 +2312,7 @@ module Aws::EFS
2302
2312
  #
2303
2313
  # <note markdown="1"> Starting in October, 2021, you will receive an error when setting
2304
2314
  # the account preference to `SHORT_ID`. Contact Amazon Web Services
2305
- # support if you receive an error and need to use short IDs for file
2315
+ # support if you receive an error and must use short IDs for file
2306
2316
  # system and mount target resources.
2307
2317
  #
2308
2318
  # </note>
@@ -2383,15 +2393,15 @@ module Aws::EFS
2383
2393
  # @return [String]
2384
2394
  #
2385
2395
  # @!attribute [rw] bypass_policy_lockout_safety_check
2386
- # (Optional) A flag to indicate whether to bypass the
2387
- # `FileSystemPolicy` lockout safety check. The policy lockout safety
2388
- # check determines whether the policy in the request will prevent the
2389
- # principal making the request will be locked out from making future
2390
- # `PutFileSystemPolicy` requests on the file system. Set
2396
+ # (Optional) A boolean that specifies whether or not to bypass the
2397
+ # `FileSystemPolicy` lockout safety check. The lockout safety check
2398
+ # determines whether the policy in the request will lock out, or
2399
+ # prevent, the IAM principal that is making the request from making
2400
+ # future `PutFileSystemPolicy` requests on this file system. Set
2391
2401
  # `BypassPolicyLockoutSafetyCheck` to `True` only when you intend to
2392
- # prevent the principal that is making the request from making a
2393
- # subsequent `PutFileSystemPolicy` request on the file system. The
2394
- # default value is False.
2402
+ # prevent the IAM principal that is making the request from making
2403
+ # subsequent `PutFileSystemPolicy` requests on this file system. The
2404
+ # default value is `False`.
2395
2405
  # @return [Boolean]
2396
2406
  #
2397
2407
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutFileSystemPolicyRequest AWS API Documentation
@@ -2425,7 +2435,7 @@ module Aws::EFS
2425
2435
  # @!attribute [rw] lifecycle_policies
2426
2436
  # An array of `LifecyclePolicy` objects that define the file system's
2427
2437
  # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
2428
- # informs EFS lifecycle management and intelligent tiering of the
2438
+ # informs EFS lifecycle management and EFS Intelligent-Tiering of the
2429
2439
  # following:
2430
2440
  #
2431
2441
  # * When to move files in the file system from primary storage to the
@@ -2436,11 +2446,10 @@ module Aws::EFS
2436
2446
  # <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
2437
2447
  # `PutLifecycleConfiguration` API action, Amazon EFS requires that
2438
2448
  # each `LifecyclePolicy` object have only a single transition. This
2439
- # means that in a request body, `LifecyclePolicies` needs to be
2440
- # structured as an array of `LifecyclePolicy` objects, one object for
2441
- # each transition, `TransitionToIA`,
2442
- # `TransitionToPrimaryStorageClass`. See the example requests in the
2443
- # following section for more information.
2449
+ # means that in a request body, `LifecyclePolicies` must be structured
2450
+ # as an array of `LifecyclePolicy` objects, one object for each
2451
+ # transition, `TransitionToIA`, `TransitionToPrimaryStorageClass`. See
2452
+ # the example requests in the following section for more information.
2444
2453
  #
2445
2454
  # </note>
2446
2455
  # @return [Array<Types::LifecyclePolicy>]
@@ -2465,8 +2474,8 @@ module Aws::EFS
2465
2474
  # @return [String]
2466
2475
  #
2467
2476
  # @!attribute [rw] source_file_system_arn
2468
- # The ARN of the current source file system in the replication
2469
- # configuration.
2477
+ # The Amazon Resource Name (ARN) of the current source file system in
2478
+ # the replication configuration.
2470
2479
  # @return [String]
2471
2480
  #
2472
2481
  # @!attribute [rw] original_source_file_system_arn
@@ -2479,7 +2488,7 @@ module Aws::EFS
2479
2488
  # @return [Time]
2480
2489
  #
2481
2490
  # @!attribute [rw] destinations
2482
- # Array of destination objects. Only one destination object is
2491
+ # An array of destination objects. Only one destination object is
2483
2492
  # supported.
2484
2493
  # @return [Array<Types::Destination>]
2485
2494
  #
@@ -2496,7 +2505,7 @@ module Aws::EFS
2496
2505
  include Aws::Structure
2497
2506
  end
2498
2507
 
2499
- # Returned if the specified file system did not have a replication
2508
+ # Returned if the specified file system does not have a replication
2500
2509
  # configuration.
2501
2510
  #
2502
2511
  # @!attribute [rw] error_code
@@ -2623,7 +2632,7 @@ module Aws::EFS
2623
2632
  end
2624
2633
 
2625
2634
  # Returned if one of the specified security groups doesn't exist in the
2626
- # subnet's VPC.
2635
+ # subnet's virtual private cloud (VPC).
2627
2636
  #
2628
2637
  # @!attribute [rw] error_code
2629
2638
  # The error code is a string that uniquely identifies an error
@@ -2739,6 +2748,35 @@ module Aws::EFS
2739
2748
  include Aws::Structure
2740
2749
  end
2741
2750
 
2751
+ # Returned when the `CreateAccessPoint` API action is called too quickly
2752
+ # and the number of Access Points in the account is nearing the limit of
2753
+ # 120.
2754
+ #
2755
+ # @!attribute [rw] error_code
2756
+ # The error code is a string that uniquely identifies an error
2757
+ # condition. It is meant to be read and understood by programs that
2758
+ # detect and handle errors by type.
2759
+ # @return [String]
2760
+ #
2761
+ # @!attribute [rw] message
2762
+ # The error message contains a generic description of the error
2763
+ # condition in English. It is intended for a human audience. Simple
2764
+ # programs display the message directly to the end user if they
2765
+ # encounter an error condition they don't know how or don't care to
2766
+ # handle. Sophisticated programs with more exhaustive error handling
2767
+ # and proper internationalization are more likely to ignore the error
2768
+ # message.
2769
+ # @return [String]
2770
+ #
2771
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/ThrottlingException AWS API Documentation
2772
+ #
2773
+ class ThrottlingException < Struct.new(
2774
+ :error_code,
2775
+ :message)
2776
+ SENSITIVE = []
2777
+ include Aws::Structure
2778
+ end
2779
+
2742
2780
  # Returned if the throughput mode or amount of provisioned throughput
2743
2781
  # can't be changed because the throughput limit of 1024 MiB/s has been
2744
2782
  # reached.
@@ -2768,8 +2806,8 @@ module Aws::EFS
2768
2806
  include Aws::Structure
2769
2807
  end
2770
2808
 
2771
- # Returned if you don’t wait at least 24 hours before changing the
2772
- # throughput mode, or decreasing the Provisioned Throughput value.
2809
+ # Returned if you don’t wait at least 24 hours before either changing
2810
+ # the throughput mode, or decreasing the Provisioned Throughput value.
2773
2811
  #
2774
2812
  # @!attribute [rw] error_code
2775
2813
  # The error code is a string that uniquely identifies an error
data/lib/aws-sdk-efs.rb CHANGED
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-efs/customizations'
48
48
  # @!group service
49
49
  module Aws::EFS
50
50
 
51
- GEM_VERSION = '1.53.0'
51
+ GEM_VERSION = '1.54.0'
52
52
 
53
53
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-efs
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.53.0
4
+ version: 1.54.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-02-24 00:00:00.000000000 Z
11
+ date: 2022-04-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core