aws-sdk-efs 1.43.0 → 1.44.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: 0b76690bd6462178167edd26b2fd40f0579ba48b6f7f3410dacb9e2e6978f093
4
- data.tar.gz: fad14b9b4225abbc7ab36a9653616c08d0bd72441ff3d603c479fff6ed6bf8bd
3
+ metadata.gz: f6616c418a83a7d11969eb5d95afee676960ec10ebc03f4282ef504e7b3c9b32
4
+ data.tar.gz: bb63055d8c2f809d645abd71030e1daf87690937ac07608d6f6364e1b77320dd
5
5
  SHA512:
6
- metadata.gz: 462494e331290a654000b6029aac663b37c29ca152b2e86d2483a8ee78bf916f8a0592624cbf06fe6f24922bc4e381cfdc3dec61306f720478a4d71e38af1bd1
7
- data.tar.gz: f10a6d16adee12dc990a26f0db8b68aa4e353beab5f1ba6712bf005ed3e88540a4fef47974c040ac1dc68b6e0a89a23ff8a65d92103cdc26ba447f761cffea6c
6
+ metadata.gz: 6d7cfbdfe5f3f80d689310c09bebb96bd9d98181759a5e555ebf2153beb87aecaa1acdf60d854eb8285e75a55b7d903d6f73f40567f8e1e0306797588f47664a
7
+ data.tar.gz: 59d0ec9efc31f8f66b47723a728ab712cb8d91c3c56d4f249544e5abf8ee2ae0c1065a6d375ffe13062bdcf6bd75ab81ab69cfae4dbe3ca645ed755f7cffbf2a
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.44.0 (2021-09-02)
5
+ ------------------
6
+
7
+ * Feature - Adds support for EFS Intelligent-Tiering, which uses EFS Lifecycle Management to monitor file access patterns and is designed to automatically transition files to and from your corresponding Infrequent Access (IA) storage classes.
8
+
4
9
  1.43.0 (2021-09-01)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.43.0
1
+ 1.44.0
@@ -353,7 +353,13 @@ module Aws::EFS
353
353
  #
354
354
  # @option params [Array<Types::Tag>] :tags
355
355
  # Creates tags associated with the access point. Each tag is a key-value
356
- # pair.
356
+ # pair, each key must be unique. For more information, see [Tagging
357
+ # Amazon Web Services resources][1] in the *Amazon Web Services General
358
+ # Reference Guide*.
359
+ #
360
+ #
361
+ #
362
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
357
363
  #
358
364
  # @option params [required, String] :file_system_id
359
365
  # The ID of the EFS file system that the access point provides access
@@ -452,8 +458,8 @@ module Aws::EFS
452
458
  # token in the request that Amazon EFS uses to ensure idempotent
453
459
  # creation (calling the operation with same creation token has no
454
460
  # effect). If a file system does not currently exist that is owned by
455
- # the caller's AWS account with the specified creation token, this
456
- # operation does the following:
461
+ # the caller's Amazon Web Services account with the specified creation
462
+ # token, this operation does the following:
457
463
  #
458
464
  # * Creates a new, empty file system. The file system will have an
459
465
  # Amazon EFS assigned ID, and an initial lifecycle state `creating`.
@@ -538,17 +544,17 @@ module Aws::EFS
538
544
  # @option params [Boolean] :encrypted
539
545
  # A Boolean value that, if true, creates an encrypted file system. When
540
546
  # creating an encrypted file system, you have the option of specifying
541
- # CreateFileSystemRequest$KmsKeyId for an existing AWS Key Management
542
- # Service (AWS KMS) customer master key (CMK). If you don't specify a
543
- # CMK, then the default CMK for Amazon EFS, `/aws/elasticfilesystem`, is
544
- # used to protect the encrypted file system.
547
+ # CreateFileSystemRequest$KmsKeyId for an existing Key Management
548
+ # Service (KMS customer master key (CMK). If you don't specify a CMK,
549
+ # then the default CMK for Amazon EFS, `/aws/elasticfilesystem`, is used
550
+ # to protect the encrypted file system.
545
551
  #
546
552
  # @option params [String] :kms_key_id
547
- # The ID of the AWS KMS CMK that you want to use to protect the
548
- # encrypted file system. This parameter is only required if you want to
549
- # use a non-default KMS key. If this parameter is not specified, the
550
- # default CMK for Amazon EFS is used. This ID can be in one of the
551
- # following formats:
553
+ # The ID of the KMS CMK that you want to use to protect the encrypted
554
+ # file system. This parameter is only required if you want to use a
555
+ # non-default KMS key. If this parameter is not specified, the default
556
+ # CMK for Amazon EFS is used. This ID can be in one of the following
557
+ # formats:
552
558
  #
553
559
  # * Key ID - A unique identifier of the key, for example
554
560
  # `1234abcd-12ab-34cd-56ef-1234567890ab`.
@@ -589,9 +595,9 @@ module Aws::EFS
589
595
  # The throughput, measured in MiB/s, that you want to provision for a
590
596
  # file system that you're creating. Valid values are 1-1024. Required
591
597
  # if `ThroughputMode` is set to `provisioned`. The upper limit for
592
- # throughput is 1024 MiB/s. To increase this limit, contact AWS Support.
593
- # For more information, see [Amazon EFS quotas that you can increase][1]
594
- # in the *Amazon EFS User Guide*.
598
+ # throughput is 1024 MiB/s. To increase this limit, contact Amazon Web
599
+ # Services Support. For more information, see [Amazon EFS quotas that
600
+ # you can increase][1] in the *Amazon EFS User Guide*.
595
601
  #
596
602
  #
597
603
  #
@@ -599,13 +605,14 @@ module Aws::EFS
599
605
  #
600
606
  # @option params [String] :availability_zone_name
601
607
  # Used to create a file system that uses One Zone storage classes. It
602
- # specifies the AWS Availability Zone in which to create the file
603
- # system. Use the format `us-east-1a` to specify the Availability Zone.
604
- # For more information about One Zone storage classes, see [Using EFS
605
- # storage classes][1] in the *Amazon EFS User Guide*.
608
+ # specifies the Amazon Web Services Availability Zone in which to create
609
+ # the file system. Use the format `us-east-1a` to specify the
610
+ # Availability Zone. For more information about One Zone storage
611
+ # classes, see [Using EFS storage classes][1] in the *Amazon EFS User
612
+ # Guide*.
606
613
  #
607
614
  # <note markdown="1"> One Zone storage classes are not available in all Availability Zones
608
- # in AWS Regions where Amazon EFS is available.
615
+ # in Amazon Web Services Regions where Amazon EFS is available.
609
616
  #
610
617
  # </note>
611
618
  #
@@ -624,8 +631,8 @@ module Aws::EFS
624
631
  # Default is `false`. However, if you specify an `AvailabilityZoneName`,
625
632
  # the default is `true`.
626
633
  #
627
- # <note markdown="1"> AWS Backup is not available in all AWS Regions where Amazon EFS is
628
- # available.
634
+ # <note markdown="1"> Backup is not available in all Amazon Web Services Regionswhere Amazon
635
+ # EFS is available.
629
636
  #
630
637
  # </note>
631
638
  #
@@ -634,10 +641,16 @@ module Aws::EFS
634
641
  # [1]: https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups
635
642
  #
636
643
  # @option params [Array<Types::Tag>] :tags
637
- # A value that specifies to create one or more tags associated with the
638
- # file system. Each tag is a user-defined key-value pair. Name your file
639
- # system on creation by including a `"Key":"Name","Value":"\{value\}"`
640
- # key-value pair.
644
+ # Use to create one or more tags associated with the file system. Each
645
+ # tag is a user-defined key-value pair. Name your file system on
646
+ # creation by including a `"Key":"Name","Value":"\{value\}"` key-value
647
+ # pair. Each key must be unique. For more information, see [Tagging
648
+ # Amazon Web Services resources][1] in the *Amazon Web Services General
649
+ # Reference Guide*.
650
+ #
651
+ #
652
+ #
653
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
641
654
  #
642
655
  # @return [Types::FileSystemDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
643
656
  #
@@ -1201,8 +1214,8 @@ module Aws::EFS
1201
1214
  # Deletes the specified tags from a file system. If the `DeleteTags`
1202
1215
  # request includes a tag key that doesn't exist, Amazon EFS ignores it
1203
1216
  # and doesn't cause an error. For more information about tags and
1204
- # related restrictions, see [Tag Restrictions][1] in the *AWS Billing
1205
- # and Cost Management User Guide*.
1217
+ # related restrictions, see [Tag restrictions][1] in the *Billing and
1218
+ # Cost Management User Guide*.
1206
1219
  #
1207
1220
  # This operation requires permissions for the
1208
1221
  # `elasticfilesystem:DeleteTags` action.
@@ -1322,11 +1335,20 @@ module Aws::EFS
1322
1335
  req.send_request(options)
1323
1336
  end
1324
1337
 
1338
+ # Returns the account preferences settings for the Amazon Web Services
1339
+ # account associated with the user making the request, in the current
1340
+ # Amazon Web Services Region. For more information, see [Managing Amazon
1341
+ # EFS resource IDs](efs/latest/ug/manage-efs-resource-ids.html).
1342
+ #
1325
1343
  # @option params [String] :next_token
1326
- # Token used for pagination.
1344
+ # (Optional) You can use `NextToken` in a subsequent request to fetch
1345
+ # the next page of Amazon Web Services account preferences if the
1346
+ # response payload was paginated.
1327
1347
  #
1328
1348
  # @option params [Integer] :max_results
1329
- # Max results used for pagination.
1349
+ # (Optional) When retrieving account preferences, you can optionally
1350
+ # specify the `MaxItems` parameter to limit the number of objects
1351
+ # returned in a response. The default value is 100.
1330
1352
  #
1331
1353
  # @return [Types::DescribeAccountPreferencesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1332
1354
  #
@@ -1421,8 +1443,8 @@ module Aws::EFS
1421
1443
  # Returns the description of a specific Amazon EFS file system if either
1422
1444
  # the file system `CreationToken` or the `FileSystemId` is provided.
1423
1445
  # Otherwise, it returns descriptions of all file systems owned by the
1424
- # caller's AWS account in the AWS Region of the endpoint that you're
1425
- # calling.
1446
+ # caller's Amazon Web Services account in the Amazon Web Services
1447
+ # Region of the endpoint that you're calling.
1426
1448
  #
1427
1449
  # When retrieving all file system descriptions, you can optionally
1428
1450
  # specify the `MaxItems` parameter to limit the number of descriptions
@@ -1559,6 +1581,9 @@ module Aws::EFS
1559
1581
  # `LifecycleConfiguration` object, the call returns an empty array in
1560
1582
  # the response.
1561
1583
  #
1584
+ # When EFS Intelligent Tiering is enabled,
1585
+ # `TransitionToPrimaryStorageClass` has a value of `AFTER_1_ACCESS`.
1586
+ #
1562
1587
  # This operation requires permissions for the
1563
1588
  # `elasticfilesystem:DescribeLifecycleConfiguration` operation.
1564
1589
  #
@@ -1599,6 +1624,7 @@ module Aws::EFS
1599
1624
  #
1600
1625
  # resp.lifecycle_policies #=> Array
1601
1626
  # 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"
1627
+ # resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
1602
1628
  #
1603
1629
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration AWS API Documentation
1604
1630
  #
@@ -1952,9 +1978,18 @@ module Aws::EFS
1952
1978
  req.send_request(options)
1953
1979
  end
1954
1980
 
1981
+ # Use this operation to set the account preference in the current Amazon
1982
+ # Web Services Region to use either long 17 character (63 bit) or short
1983
+ # 8 character (32 bit) IDs for new EFS file systems and mount targets
1984
+ # created. All existing resource IDs are not affected by any changes you
1985
+ # make. You can set the ID preference during the opt-in period as EFS
1986
+ # transitions to long resource IDs. For more information, see [Managing
1987
+ # Amazon EFS resource IDs](efs/latest/ug/manage-efs-resource-ids.html).
1988
+ #
1955
1989
  # @option params [required, String] :resource_id_type
1956
- # A preference indicating a choice to use 63bit/32bit IDs for all
1957
- # applicable resources.
1990
+ # Specifies the EFS resource ID preference to set for the user's Amazon
1991
+ # Web Services account, in the current Amazon Web Services Region,
1992
+ # either `LONG_ID` (17 characters), or `SHORT_ID` (8 characters).
1958
1993
  #
1959
1994
  # @return [Types::PutAccountPreferencesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1960
1995
  #
@@ -2090,8 +2125,11 @@ module Aws::EFS
2090
2125
  # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
2091
2126
  # defines when files in an Amazon EFS file system are automatically
2092
2127
  # transitioned to the lower-cost EFS Infrequent Access (IA) storage
2093
- # class. A `LifecycleConfiguration` applies to all files in a file
2094
- # system.
2128
+ # class. To enable EFS Intelligent Tiering, set the value of
2129
+ # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`. For more
2130
+ # information, see [EFS Lifecycle Management][1].
2131
+ #
2132
+ # A `LifecycleConfiguration` applies to all files in a file system.
2095
2133
  #
2096
2134
  # Each Amazon EFS file system supports one lifecycle configuration,
2097
2135
  # which applies to all files in the file system. If a
@@ -2114,8 +2152,12 @@ module Aws::EFS
2114
2152
  # `elasticfilesystem:PutLifecycleConfiguration` operation.
2115
2153
  #
2116
2154
  # To apply a `LifecycleConfiguration` object to an encrypted file
2117
- # system, you need the same AWS Key Management Service (AWS KMS)
2118
- # permissions as when you created the encrypted file system.
2155
+ # system, you need the same Key Management Service permissions as when
2156
+ # you created the encrypted file system.
2157
+ #
2158
+ #
2159
+ #
2160
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html
2119
2161
  #
2120
2162
  # @option params [required, String] :file_system_id
2121
2163
  # The ID of the file system for which you are creating the
@@ -2163,6 +2205,7 @@ module Aws::EFS
2163
2205
  # lifecycle_policies: [ # required
2164
2206
  # {
2165
2207
  # transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS
2208
+ # transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
2166
2209
  # },
2167
2210
  # ],
2168
2211
  # })
@@ -2171,6 +2214,7 @@ module Aws::EFS
2171
2214
  #
2172
2215
  # resp.lifecycle_policies #=> Array
2173
2216
  # 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"
2217
+ # resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
2174
2218
  #
2175
2219
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutLifecycleConfiguration AWS API Documentation
2176
2220
  #
@@ -2343,7 +2387,7 @@ module Aws::EFS
2343
2387
  params: params,
2344
2388
  config: config)
2345
2389
  context[:gem_name] = 'aws-sdk-efs'
2346
- context[:gem_version] = '1.43.0'
2390
+ context[:gem_version] = '1.44.0'
2347
2391
  Seahorse::Client::Request.new(handlers, context)
2348
2392
  end
2349
2393
 
@@ -141,6 +141,7 @@ module Aws::EFS
141
141
  Token = Shapes::StringShape.new(name: 'Token')
142
142
  TooManyRequests = Shapes::StructureShape.new(name: 'TooManyRequests')
143
143
  TransitionToIARules = Shapes::StringShape.new(name: 'TransitionToIARules')
144
+ TransitionToPrimaryStorageClassRules = Shapes::StringShape.new(name: 'TransitionToPrimaryStorageClassRules')
144
145
  Uid = Shapes::IntegerShape.new(name: 'Uid')
145
146
  UnsupportedAvailabilityZone = Shapes::StructureShape.new(name: 'UnsupportedAvailabilityZone')
146
147
  UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
@@ -386,6 +387,7 @@ module Aws::EFS
386
387
  LifecyclePolicies.member = Shapes::ShapeRef.new(shape: LifecyclePolicy)
387
388
 
388
389
  LifecyclePolicy.add_member(:transition_to_ia, Shapes::ShapeRef.new(shape: TransitionToIARules, location_name: "TransitionToIA"))
390
+ LifecyclePolicy.add_member(:transition_to_primary_storage_class, Shapes::ShapeRef.new(shape: TransitionToPrimaryStorageClassRules, location_name: "TransitionToPrimaryStorageClass"))
389
391
  LifecyclePolicy.struct_class = Types::LifecyclePolicy
390
392
 
391
393
  ListTagsForResourceRequest.add_member(:resource_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location: "uri", location_name: "ResourceId"))
@@ -73,7 +73,8 @@ module Aws::EFS
73
73
  # @return [Types::RootDirectory]
74
74
  #
75
75
  # @!attribute [rw] owner_id
76
- # Identified the AWS account that owns the access point resource.
76
+ # Identified the Amazon Web Services account that owns the access
77
+ # point resource.
77
78
  # @return [String]
78
79
  #
79
80
  # @!attribute [rw] life_cycle_state
@@ -97,8 +98,8 @@ module Aws::EFS
97
98
  include Aws::Structure
98
99
  end
99
100
 
100
- # Returned if the AWS account has already created the maximum number of
101
- # access points allowed per file system.
101
+ # Returned if the Amazon Web Services account has already created the
102
+ # maximum number of access points allowed per file system.
102
103
  #
103
104
  # @!attribute [rw] error_code
104
105
  # @return [String]
@@ -116,7 +117,7 @@ module Aws::EFS
116
117
  end
117
118
 
118
119
  # Returned if the specified `AccessPointId` value doesn't exist in the
119
- # requester's AWS account.
120
+ # requester's Amazon Web Services account.
120
121
  #
121
122
  # @!attribute [rw] error_code
122
123
  # @return [String]
@@ -265,7 +266,13 @@ module Aws::EFS
265
266
  #
266
267
  # @!attribute [rw] tags
267
268
  # Creates tags associated with the access point. Each tag is a
268
- # key-value pair.
269
+ # key-value pair, each key must be unique. For more information, see
270
+ # [Tagging Amazon Web Services resources][1] in the *Amazon Web
271
+ # Services General Reference Guide*.
272
+ #
273
+ #
274
+ #
275
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
269
276
  # @return [Array<Types::Tag>]
270
277
  #
271
278
  # @!attribute [rw] file_system_id
@@ -353,19 +360,19 @@ module Aws::EFS
353
360
  # @!attribute [rw] encrypted
354
361
  # A Boolean value that, if true, creates an encrypted file system.
355
362
  # When creating an encrypted file system, you have the option of
356
- # specifying CreateFileSystemRequest$KmsKeyId for an existing AWS Key
357
- # Management Service (AWS KMS) customer master key (CMK). If you
358
- # don't specify a CMK, then the default CMK for Amazon EFS,
363
+ # specifying CreateFileSystemRequest$KmsKeyId for an existing Key
364
+ # Management Service (KMS customer master key (CMK). If you don't
365
+ # specify a CMK, then the default CMK for Amazon EFS,
359
366
  # `/aws/elasticfilesystem`, is used to protect the encrypted file
360
367
  # system.
361
368
  # @return [Boolean]
362
369
  #
363
370
  # @!attribute [rw] kms_key_id
364
- # The ID of the AWS KMS CMK that you want to use to protect the
365
- # encrypted file system. This parameter is only required if you want
366
- # to use a non-default KMS key. If this parameter is not specified,
367
- # the default CMK for Amazon EFS is used. This ID can be in one of the
368
- # following formats:
371
+ # The ID of the KMS CMK that you want to use to protect the encrypted
372
+ # file system. This parameter is only required if you want to use a
373
+ # non-default KMS key. If this parameter is not specified, the default
374
+ # CMK for Amazon EFS is used. This ID can be in one of the following
375
+ # formats:
369
376
  #
370
377
  # * Key ID - A unique identifier of the key, for example
371
378
  # `1234abcd-12ab-34cd-56ef-1234567890ab`.
@@ -408,9 +415,9 @@ module Aws::EFS
408
415
  # The throughput, measured in MiB/s, that you want to provision for a
409
416
  # file system that you're creating. Valid values are 1-1024. Required
410
417
  # if `ThroughputMode` is set to `provisioned`. The upper limit for
411
- # throughput is 1024 MiB/s. To increase this limit, contact AWS
412
- # Support. For more information, see [Amazon EFS quotas that you can
413
- # increase][1] in the *Amazon EFS User Guide*.
418
+ # throughput is 1024 MiB/s. To increase this limit, contact Amazon Web
419
+ # Services Support. For more information, see [Amazon EFS quotas that
420
+ # you can increase][1] in the *Amazon EFS User Guide*.
414
421
  #
415
422
  #
416
423
  #
@@ -419,13 +426,14 @@ module Aws::EFS
419
426
  #
420
427
  # @!attribute [rw] availability_zone_name
421
428
  # Used to create a file system that uses One Zone storage classes. It
422
- # specifies the AWS Availability Zone in which to create the file
423
- # system. Use the format `us-east-1a` to specify the Availability
424
- # Zone. For more information about One Zone storage classes, see
425
- # [Using EFS storage classes][1] in the *Amazon EFS User Guide*.
429
+ # specifies the Amazon Web Services Availability Zone in which to
430
+ # create the file system. Use the format `us-east-1a` to specify the
431
+ # Availability Zone. For more information about One Zone storage
432
+ # classes, see [Using EFS storage classes][1] in the *Amazon EFS User
433
+ # Guide*.
426
434
  #
427
435
  # <note markdown="1"> One Zone storage classes are not available in all Availability Zones
428
- # in AWS Regions where Amazon EFS is available.
436
+ # in Amazon Web Services Regions where Amazon EFS is available.
429
437
  #
430
438
  # </note>
431
439
  #
@@ -445,8 +453,8 @@ module Aws::EFS
445
453
  # Default is `false`. However, if you specify an
446
454
  # `AvailabilityZoneName`, the default is `true`.
447
455
  #
448
- # <note markdown="1"> AWS Backup is not available in all AWS Regions where Amazon EFS is
449
- # available.
456
+ # <note markdown="1"> Backup is not available in all Amazon Web Services Regionswhere
457
+ # Amazon EFS is available.
450
458
  #
451
459
  # </note>
452
460
  #
@@ -456,10 +464,16 @@ module Aws::EFS
456
464
  # @return [Boolean]
457
465
  #
458
466
  # @!attribute [rw] tags
459
- # A value that specifies to create one or more tags associated with
460
- # the file system. Each tag is a user-defined key-value pair. Name
461
- # your file system on creation by including a
462
- # `"Key":"Name","Value":"\{value\}"` key-value pair.
467
+ # Use to create one or more tags associated with the file system. Each
468
+ # tag is a user-defined key-value pair. Name your file system on
469
+ # creation by including a `"Key":"Name","Value":"\{value\}"` key-value
470
+ # pair. Each key must be unique. For more information, see [Tagging
471
+ # Amazon Web Services resources][1] in the *Amazon Web Services
472
+ # General Reference Guide*.
473
+ #
474
+ #
475
+ #
476
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
463
477
  # @return [Array<Types::Tag>]
464
478
  #
465
479
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateFileSystemRequest AWS API Documentation
@@ -793,11 +807,15 @@ module Aws::EFS
793
807
  # }
794
808
  #
795
809
  # @!attribute [rw] next_token
796
- # Token used for pagination.
810
+ # (Optional) You can use `NextToken` in a subsequent request to fetch
811
+ # the next page of Amazon Web Services account preferences if the
812
+ # response payload was paginated.
797
813
  # @return [String]
798
814
  #
799
815
  # @!attribute [rw] max_results
800
- # Max results used for pagination.
816
+ # (Optional) When retrieving account preferences, you can optionally
817
+ # specify the `MaxItems` parameter to limit the number of objects
818
+ # returned in a response. The default value is 100.
801
819
  # @return [Integer]
802
820
  #
803
821
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeAccountPreferencesRequest AWS API Documentation
@@ -810,10 +828,15 @@ module Aws::EFS
810
828
  end
811
829
 
812
830
  # @!attribute [rw] resource_id_preference
831
+ # Describes the resource ID preference setting for the Amazon Web
832
+ # Services account associated with the user making the request, in the
833
+ # current Amazon Web Services Region.
813
834
  # @return [Types::ResourceIdPreference]
814
835
  #
815
836
  # @!attribute [rw] next_token
816
- # Token used for pagination.
837
+ # Present if there are more records than returned in the response. You
838
+ # can use the `NextToken` in the subsequent request to fetch the
839
+ # additional descriptions.
817
840
  # @return [String]
818
841
  #
819
842
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeAccountPreferencesResponse AWS API Documentation
@@ -1156,9 +1179,9 @@ module Aws::EFS
1156
1179
  # A description of the file system.
1157
1180
  #
1158
1181
  # @!attribute [rw] owner_id
1159
- # The AWS account that created the file system. If the file system was
1160
- # created by an IAM user, the parent account to which the user belongs
1161
- # is the owner.
1182
+ # The Amazon Web Services account that created the file system. If the
1183
+ # file system was created by an IAM user, the parent account to which
1184
+ # the user belongs is the owner.
1162
1185
  # @return [String]
1163
1186
  #
1164
1187
  # @!attribute [rw] creation_token
@@ -1220,8 +1243,8 @@ module Aws::EFS
1220
1243
  # @return [Boolean]
1221
1244
  #
1222
1245
  # @!attribute [rw] kms_key_id
1223
- # The ID of an AWS Key Management Service (AWS KMS) customer master
1224
- # key (CMK) that was used to protect the encrypted file system.
1246
+ # The ID of an Key Management Service customer master key (CMK) that
1247
+ # was used to protect the encrypted file system.
1225
1248
  # @return [String]
1226
1249
  #
1227
1250
  # @!attribute [rw] throughput_mode
@@ -1240,10 +1263,10 @@ module Aws::EFS
1240
1263
  # @return [Float]
1241
1264
  #
1242
1265
  # @!attribute [rw] availability_zone_name
1243
- # Describes the AWS Availability Zone in which the file system is
1244
- # located, and is valid only for file systems using One Zone storage
1245
- # classes. For more information, see [Using EFS storage classes][1] in
1246
- # the *Amazon EFS User Guide*.
1266
+ # Describes the Amazon Web Services Availability Zone in which the
1267
+ # file system is located, and is valid only for file systems using One
1268
+ # Zone storage classes. For more information, see [Using EFS storage
1269
+ # classes][1] in the *Amazon EFS User Guide*.
1247
1270
  #
1248
1271
  #
1249
1272
  #
@@ -1253,8 +1276,9 @@ module Aws::EFS
1253
1276
  # @!attribute [rw] availability_zone_id
1254
1277
  # The unique and consistent identifier of the Availability Zone in
1255
1278
  # which the file system's One Zone storage classes exist. For
1256
- # example, `use1-az1` is an Availability Zone ID for the us-east-1 AWS
1257
- # Region, and it has the same location in every AWS account.
1279
+ # example, `use1-az1` is an Availability Zone ID for the us-east-1
1280
+ # Amazon Web Services Region, and it has the same location in every
1281
+ # Amazon Web Services account.
1258
1282
  # @return [String]
1259
1283
  #
1260
1284
  # @!attribute [rw] tags
@@ -1303,8 +1327,8 @@ module Aws::EFS
1303
1327
  include Aws::Structure
1304
1328
  end
1305
1329
 
1306
- # Returned if the AWS account has already created the maximum number of
1307
- # file systems allowed per account.
1330
+ # Returned if the Amazon Web Services account has already created the
1331
+ # maximum number of file systems allowed per account.
1308
1332
  #
1309
1333
  # @!attribute [rw] error_code
1310
1334
  # @return [String]
@@ -1322,7 +1346,7 @@ module Aws::EFS
1322
1346
  end
1323
1347
 
1324
1348
  # Returned if the specified `FileSystemId` value doesn't exist in the
1325
- # requester's AWS account.
1349
+ # requester's Amazon Web Services account.
1326
1350
  #
1327
1351
  # @!attribute [rw] error_code
1328
1352
  # @return [String]
@@ -1512,8 +1536,8 @@ module Aws::EFS
1512
1536
  end
1513
1537
 
1514
1538
  # @!attribute [rw] lifecycle_policies
1515
- # An array of lifecycle management policies. Currently, EFS supports a
1516
- # maximum of one policy per file system.
1539
+ # An array of lifecycle management policies. EFS supports a maximum of
1540
+ # one policy per file system.
1517
1541
  # @return [Array<Types::LifecyclePolicy>]
1518
1542
  #
1519
1543
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/LifecycleConfigurationDescription AWS API Documentation
@@ -1532,19 +1556,26 @@ module Aws::EFS
1532
1556
  #
1533
1557
  # {
1534
1558
  # transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS
1559
+ # transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
1535
1560
  # }
1536
1561
  #
1537
1562
  # @!attribute [rw] transition_to_ia
1538
- # A value that describes the period of time that a file is not
1539
- # accessed, after which it transitions to the IA storage class.
1540
- # Metadata operations such as listing the contents of a directory
1541
- # don't count as file access events.
1563
+ # Describes the period of time that a file is not accessed, after
1564
+ # which it transitions to the IA storage class. Metadata operations
1565
+ # such as listing the contents of a directory don't count as file
1566
+ # access events.
1567
+ # @return [String]
1568
+ #
1569
+ # @!attribute [rw] transition_to_primary_storage_class
1570
+ # Describes the policy used to transition a file from infequent access
1571
+ # storage to primary storage.
1542
1572
  # @return [String]
1543
1573
  #
1544
1574
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/LifecyclePolicy AWS API Documentation
1545
1575
  #
1546
1576
  class LifecyclePolicy < Struct.new(
1547
- :transition_to_ia)
1577
+ :transition_to_ia,
1578
+ :transition_to_primary_storage_class)
1548
1579
  SENSITIVE = []
1549
1580
  include Aws::Structure
1550
1581
  end
@@ -1650,7 +1681,7 @@ module Aws::EFS
1650
1681
  # Provides a description of a mount target.
1651
1682
  #
1652
1683
  # @!attribute [rw] owner_id
1653
- # AWS account ID that owns the resource.
1684
+ # Amazon Web Services account ID that owns the resource.
1654
1685
  # @return [String]
1655
1686
  #
1656
1687
  # @!attribute [rw] mount_target_id
@@ -1682,16 +1713,17 @@ module Aws::EFS
1682
1713
  # @!attribute [rw] availability_zone_id
1683
1714
  # The unique and consistent identifier of the Availability Zone that
1684
1715
  # the mount target resides in. For example, `use1-az1` is an AZ ID for
1685
- # the us-east-1 Region and it has the same location in every AWS
1686
- # account.
1716
+ # the us-east-1 Region and it has the same location in every Amazon
1717
+ # Web Services account.
1687
1718
  # @return [String]
1688
1719
  #
1689
1720
  # @!attribute [rw] availability_zone_name
1690
1721
  # The name of the Availability Zone in which the mount target is
1691
1722
  # located. Availability Zones are independently mapped to names for
1692
- # each AWS account. For example, the Availability Zone `us-east-1a`
1693
- # for your AWS account might not be the same location as `us-east-1a`
1694
- # for another AWS account.
1723
+ # each Amazon Web Services account. For example, the Availability Zone
1724
+ # `us-east-1a` for your Amazon Web Services account might not be the
1725
+ # same location as `us-east-1a` for another Amazon Web Services
1726
+ # account.
1695
1727
  # @return [String]
1696
1728
  #
1697
1729
  # @!attribute [rw] vpc_id
@@ -1717,7 +1749,7 @@ module Aws::EFS
1717
1749
  end
1718
1750
 
1719
1751
  # Returned if there is no mount target with the specified ID found in
1720
- # the caller's account.
1752
+ # the caller's Amazon Web Services account.
1721
1753
  #
1722
1754
  # @!attribute [rw] error_code
1723
1755
  # @return [String]
@@ -1735,11 +1767,11 @@ module Aws::EFS
1735
1767
  end
1736
1768
 
1737
1769
  # The calling account has reached the limit for elastic network
1738
- # interfaces for the specific AWS Region. The client should try to
1739
- # delete some elastic network interfaces or get the account limit
1740
- # raised. For more information, see [Amazon VPC Limits][1] in the
1741
- # <i>Amazon VPC User Guide </i> (see the Network interfaces per VPC
1742
- # entry in the table).
1770
+ # interfaces for the specific Amazon Web Services Region. The client
1771
+ # should try to delete some elastic network interfaces or get the
1772
+ # account limit raised. For more information, see [Amazon VPC Limits][1]
1773
+ # in the <i>Amazon VPC User Guide </i> (see the Network interfaces per
1774
+ # VPC entry in the table).
1743
1775
  #
1744
1776
  #
1745
1777
  #
@@ -1842,8 +1874,10 @@ module Aws::EFS
1842
1874
  # }
1843
1875
  #
1844
1876
  # @!attribute [rw] resource_id_type
1845
- # A preference indicating a choice to use 63bit/32bit IDs for all
1846
- # applicable resources.
1877
+ # Specifies the EFS resource ID preference to set for the user's
1878
+ # Amazon Web Services account, in the current Amazon Web Services
1879
+ # Region, either `LONG_ID` (17 characters), or `SHORT_ID` (8
1880
+ # characters).
1847
1881
  # @return [String]
1848
1882
  #
1849
1883
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutAccountPreferencesRequest AWS API Documentation
@@ -1855,6 +1889,9 @@ module Aws::EFS
1855
1889
  end
1856
1890
 
1857
1891
  # @!attribute [rw] resource_id_preference
1892
+ # Describes the resource type and its ID preference for the user's
1893
+ # Amazon Web Services account, in the current Amazon Web Services
1894
+ # Region.
1858
1895
  # @return [Types::ResourceIdPreference]
1859
1896
  #
1860
1897
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutAccountPreferencesResponse AWS API Documentation
@@ -1947,6 +1984,7 @@ module Aws::EFS
1947
1984
  # lifecycle_policies: [ # required
1948
1985
  # {
1949
1986
  # transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS
1987
+ # transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
1950
1988
  # },
1951
1989
  # ],
1952
1990
  # }
@@ -1972,13 +2010,18 @@ module Aws::EFS
1972
2010
  include Aws::Structure
1973
2011
  end
1974
2012
 
2013
+ # Describes the resource type and its ID preference for the user's
2014
+ # Amazon Web Services account, in the current Amazon Web Services
2015
+ # Region.
2016
+ #
1975
2017
  # @!attribute [rw] resource_id_type
1976
- # A preference indicating a choice to use 63bit/32bit IDs for all
1977
- # applicable resources.
2018
+ # Identifies the EFS resource ID preference, either `LONG_ID` (17
2019
+ # characters) or `SHORT_ID` (8 characters).
1978
2020
  # @return [String]
1979
2021
  #
1980
2022
  # @!attribute [rw] resources
1981
- # EFS resources to which a preference applies to.
2023
+ # Identifies the Amazon EFS resources to which the ID preference
2024
+ # setting applies, `FILE_SYSTEM` and `MOUNT_TARGET`.
1982
2025
  # @return [Array<String>]
1983
2026
  #
1984
2027
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/ResourceIdPreference AWS API Documentation
@@ -2274,8 +2317,8 @@ module Aws::EFS
2274
2317
  include Aws::Structure
2275
2318
  end
2276
2319
 
2277
- # Returned if the AWS Backup service is not available in the Region in
2278
- # which the request was made.
2320
+ # Returned if the Backup service is not available in the Amazon Web
2321
+ # Services Region in which the request was made.
2279
2322
  #
2280
2323
  # @!attribute [rw] error_code
2281
2324
  # @return [String]
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.43.0'
51
+ GEM_VERSION = '1.44.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.43.0
4
+ version: 1.44.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: 2021-09-01 00:00:00.000000000 Z
11
+ date: 2021-09-02 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core