aws-sdk-efs 1.42.0 → 1.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3431764699e5796d6321ac8155e860cc0b6bbf4dddbebd4d16bb5730600f4414
-  data.tar.gz: a6bbab2bc8a7b4e20fe7b138599e6bc4f523f95cefd3b1514b9ecfa80a12320c
+  metadata.gz: 8df0fca04850c2de03da3be698676a6a7efda52ca1bc83896c60687f954d7dc3
+  data.tar.gz: 0c75c0947ee46a8d9d11730aaf93dca6ecc7d314c4b25087d1b73c92de076ffa
 SHA512:
-  metadata.gz: b55c5b31a1726a137635791178e6a02a698e750d29ff742cc4faf296e03d2061eb42b6e36042b36eb1eb01e94fef200744b48394aa47e3e8450173b6e650181b
-  data.tar.gz: 0c125da8569c71439286b4a2f6e38f03d247072520c5a572b4d3eb860dcc4101519d69d2adb9c417ae97e8f84c54d8164ee2fab3f48c79efc62139c8a2cfe7f0
+  metadata.gz: 70dc2e6ab72150e405f00db84e764ba1e071769c78eb5815279dfa3b3588bcd57302fa2afe24f3015e1eaadfce061e337e765f27a6a494bac2047c03060cfa0a
+  data.tar.gz: 59966dd281e3b7dbf15ca7422e978e0afc0ee6fd2669caf7dc4b8c484193fdc8365a005fdee42070aeec491f7c50a38088af5515bcd7aecad76dcb0b9510a382

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.46.0 (2021-10-15)
+------------------
+
+* Feature - EFS adds documentation for a new exception for short identifiers to be thrown after its migration to long resource identifiers.
+
+1.45.0 (2021-10-04)
+------------------
+
+* Feature - EFS adds a new exception for short identifiers to be thrown after its migration to long resource identifiers.
+
+1.44.0 (2021-09-02)
+------------------
+
+* 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.
+
+1.43.0 (2021-09-01)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.42.0 (2021-07-30)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.42.0
+1.46.0

data/lib/aws-sdk-efs/client.rb

@@ -353,7 +353,13 @@ module Aws::EFS
     #
     # @option params [Array<Types::Tag>] :tags
     #   Creates tags associated with the access point. Each tag is a key-value
-    #   pair.
+    #   pair, each key must be unique. For more information, see [Tagging
+    #   Amazon Web Services resources][1] in the *Amazon Web Services General
+    #   Reference Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
     #
     # @option params [required, String] :file_system_id
     #   The ID of the EFS file system that the access point provides access
@@ -452,8 +458,8 @@ module Aws::EFS
     # token in the request that Amazon EFS uses to ensure idempotent
     # creation (calling the operation with same creation token has no
     # effect). If a file system does not currently exist that is owned by
-    # the caller's AWS account with the specified creation token, this
-    # operation does the following:
+    # the caller's Amazon Web Services account with the specified creation
+    # token, this operation does the following:
     #
     # * Creates a new, empty file system. The file system will have an
     #   Amazon EFS assigned ID, and an initial lifecycle state `creating`.
@@ -538,17 +544,17 @@ module Aws::EFS
     # @option params [Boolean] :encrypted
     #   A Boolean value that, if true, creates an encrypted file system. When
     #   creating an encrypted file system, you have the option of specifying
-    #   CreateFileSystemRequest$KmsKeyId for an existing AWS Key Management
-    #   Service (AWS KMS) customer master key (CMK). If you don't specify a
-    #   CMK, then the default CMK for Amazon EFS, `/aws/elasticfilesystem`, is
-    #   used to protect the encrypted file system.
+    #   CreateFileSystemRequest$KmsKeyId for an existing Key Management
+    #   Service (KMS customer master key (CMK). If you don't specify a CMK,
+    #   then the default CMK for Amazon EFS, `/aws/elasticfilesystem`, is used
+    #   to protect the encrypted file system.
     #
     # @option params [String] :kms_key_id
-    #   The ID of the AWS KMS CMK that you want to use to protect the
-    #   encrypted file system. This parameter is only required if you want to
-    #   use a non-default KMS key. If this parameter is not specified, the
-    #   default CMK for Amazon EFS is used. This ID can be in one of the
-    #   following formats:
+    #   The ID of the KMS CMK that you want to use to protect the encrypted
+    #   file system. This parameter is only required if you want to use a
+    #   non-default KMS key. If this parameter is not specified, the default
+    #   CMK for Amazon EFS is used. This ID can be in one of the following
+    #   formats:
     #
     #   * Key ID - A unique identifier of the key, for example
     #     `1234abcd-12ab-34cd-56ef-1234567890ab`.
@@ -589,9 +595,9 @@ module Aws::EFS
     #   The throughput, measured in MiB/s, that you want to provision for a
     #   file system that you're creating. Valid values are 1-1024. Required
     #   if `ThroughputMode` is set to `provisioned`. The upper limit for
-    #   throughput is 1024 MiB/s. To increase this limit, contact AWS Support.
-    #   For more information, see [Amazon EFS quotas that you can increase][1]
-    #   in the *Amazon EFS User Guide*.
+    #   throughput is 1024 MiB/s. To increase this limit, contact Amazon Web
+    #   Services Support. For more information, see [Amazon EFS quotas that
+    #   you can increase][1] in the *Amazon EFS User Guide*.
     #
     #
     #
@@ -599,13 +605,14 @@ module Aws::EFS
     #
     # @option params [String] :availability_zone_name
     #   Used to create a file system that uses One Zone storage classes. It
-    #   specifies the AWS Availability Zone in which to create the file
-    #   system. Use the format `us-east-1a` to specify the Availability Zone.
-    #   For more information about One Zone storage classes, see [Using EFS
-    #   storage classes][1] in the *Amazon EFS User Guide*.
+    #   specifies the Amazon Web Services Availability Zone in which to create
+    #   the file system. Use the format `us-east-1a` to specify the
+    #   Availability Zone. For more information about One Zone storage
+    #   classes, see [Using EFS storage classes][1] in the *Amazon EFS User
+    #   Guide*.
     #
     #   <note markdown="1"> One Zone storage classes are not available in all Availability Zones
-    #   in AWS Regions where Amazon EFS is available.
+    #   in Amazon Web Services Regions where Amazon EFS is available.
     #
     #    </note>
     #
@@ -624,8 +631,8 @@ module Aws::EFS
     #   Default is `false`. However, if you specify an `AvailabilityZoneName`,
     #   the default is `true`.
     #
-    #   <note markdown="1"> AWS Backup is not available in all AWS Regions where Amazon EFS is
-    #   available.
+    #   <note markdown="1"> Backup is not available in all Amazon Web Services Regionswhere Amazon
+    #   EFS is available.
     #
     #    </note>
     #
@@ -634,10 +641,16 @@ module Aws::EFS
     #   [1]: https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups
     #
     # @option params [Array<Types::Tag>] :tags
-    #   A value that specifies to create one or more tags associated with the
-    #   file system. Each tag is a user-defined key-value pair. Name your file
-    #   system on creation by including a `"Key":"Name","Value":"\{value\}"`
-    #   key-value pair.
+    #   Use to create one or more tags associated with the file system. Each
+    #   tag is a user-defined key-value pair. Name your file system on
+    #   creation by including a `"Key":"Name","Value":"\{value\}"` key-value
+    #   pair. Each key must be unique. For more information, see [Tagging
+    #   Amazon Web Services resources][1] in the *Amazon Web Services General
+    #   Reference Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
     #
     # @return [Types::FileSystemDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1201,8 +1214,8 @@ module Aws::EFS
     # Deletes the specified tags from a file system. If the `DeleteTags`
     # request includes a tag key that doesn't exist, Amazon EFS ignores it
     # and doesn't cause an error. For more information about tags and
-    # related restrictions, see [Tag Restrictions][1] in the *AWS Billing
-    # and Cost Management User Guide*.
+    # related restrictions, see [Tag restrictions][1] in the *Billing and
+    # Cost Management User Guide*.
     #
     # This operation requires permissions for the
     # `elasticfilesystem:DeleteTags` action.
@@ -1322,11 +1335,20 @@ module Aws::EFS
       req.send_request(options)
     end
 
+    # Returns the account preferences settings for the Amazon Web Services
+    # account associated with the user making the request, in the current
+    # Amazon Web Services Region. For more information, see [Managing Amazon
+    # EFS resource IDs](efs/latest/ug/manage-efs-resource-ids.html).
+    #
     # @option params [String] :next_token
-    #   Token used for pagination.
+    #   (Optional) You can use `NextToken` in a subsequent request to fetch
+    #   the next page of Amazon Web Services account preferences if the
+    #   response payload was paginated.
     #
     # @option params [Integer] :max_results
-    #   Max results used for pagination.
+    #   (Optional) When retrieving account preferences, you can optionally
+    #   specify the `MaxItems` parameter to limit the number of objects
+    #   returned in a response. The default value is 100.
     #
     # @return [Types::DescribeAccountPreferencesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1421,8 +1443,8 @@ module Aws::EFS
     # Returns the description of a specific Amazon EFS file system if either
     # the file system `CreationToken` or the `FileSystemId` is provided.
     # Otherwise, it returns descriptions of all file systems owned by the
-    # caller's AWS account in the AWS Region of the endpoint that you're
-    # calling.
+    # caller's Amazon Web Services account in the Amazon Web Services
+    # Region of the endpoint that you're calling.
     #
     # When retrieving all file system descriptions, you can optionally
     # specify the `MaxItems` parameter to limit the number of descriptions
@@ -1559,6 +1581,9 @@ module Aws::EFS
     # `LifecycleConfiguration` object, the call returns an empty array in
     # the response.
     #
+    # When EFS Intelligent Tiering is enabled,
+    # `TransitionToPrimaryStorageClass` has a value of `AFTER_1_ACCESS`.
+    #
     # This operation requires permissions for the
     # `elasticfilesystem:DescribeLifecycleConfiguration` operation.
     #
@@ -1599,6 +1624,7 @@ module Aws::EFS
     #
     #   resp.lifecycle_policies #=> Array
     #   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"
+    #   resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration AWS API Documentation
     #
@@ -1952,9 +1978,36 @@ module Aws::EFS
       req.send_request(options)
     end
 
+    # Use this operation to set the account preference in the current Amazon
+    # Web Services Region to use long 17 character (63 bit) or short 8
+    # character (32 bit) resource IDs for new EFS file system and mount
+    # target resources. All existing resource IDs are not affected by any
+    # changes you make. You can set the ID preference during the opt-in
+    # period as EFS transitions to long resource IDs. For more information,
+    # see [Managing Amazon EFS resource IDs][1].
+    #
+    # <note markdown="1"> Starting in October, 2021, you will receive an error if you try to set
+    # the account preference to use the short 8 character format resource
+    # ID. Contact Amazon Web Services support if you receive an error and
+    # need to use short IDs for file system and mount target resources.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html
+    #
     # @option params [required, String] :resource_id_type
-    #   A preference indicating a choice to use 63bit/32bit IDs for all
-    #   applicable resources.
+    #   Specifies the EFS resource ID preference to set for the user's Amazon
+    #   Web Services account, in the current Amazon Web Services Region,
+    #   either `LONG_ID` (17 characters), or `SHORT_ID` (8 characters).
+    #
+    #   <note markdown="1"> Starting in October, 2021, you will receive an error when setting the
+    #   account preference to `SHORT_ID`. Contact Amazon Web Services support
+    #   if you receive an error and need to use short IDs for file system and
+    #   mount target resources.
+    #
+    #    </note>
     #
     # @return [Types::PutAccountPreferencesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2025,7 +2078,9 @@ module Aws::EFS
     # the default policy. For more information about the default file system
     # policy, see [Default EFS File System Policy][1].
     #
-    # EFS file system policies have a 20,000 character limit.
+    # <note markdown="1"> EFS file system policies have a 20,000 character limit.
+    #
+    #  </note>
     #
     # This operation requires permissions for the
     # `elasticfilesystem:PutFileSystemPolicy` action.
@@ -2090,8 +2145,9 @@ module Aws::EFS
     # `LifecycleConfiguration` object. A `LifecycleConfiguration` object
     # defines when files in an Amazon EFS file system are automatically
     # transitioned to the lower-cost EFS Infrequent Access (IA) storage
-    # class. A `LifecycleConfiguration` applies to all files in a file
-    # system.
+    # class. To enable EFS Intelligent Tiering, set the value of
+    # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`. For more
+    # information, see [EFS Lifecycle Management][1].
     #
     # Each Amazon EFS file system supports one lifecycle configuration,
     # which applies to all files in the file system. If a
@@ -2099,7 +2155,8 @@ module Aws::EFS
     # system, a `PutLifecycleConfiguration` call modifies the existing
     # configuration. A `PutLifecycleConfiguration` call with an empty
     # `LifecyclePolicies` array in the request body deletes any existing
-    # `LifecycleConfiguration` and disables lifecycle management.
+    # `LifecycleConfiguration` and turns off lifecycle management for the
+    # file system.
     #
     # In the request, specify the following:
     #
@@ -2107,15 +2164,22 @@ module Aws::EFS
     #   modifying lifecycle management.
     #
     # * A `LifecyclePolicies` array of `LifecyclePolicy` objects that define
-    #   when files are moved to the IA storage class. The array can contain
-    #   only one `LifecyclePolicy` item.
+    #   when files are moved to the IA storage class. Amazon EFS requires
+    #   that each `LifecyclePolicy` object have only have a single
+    #   transition, so the `LifecyclePolicies` array needs to be structured
+    #   with separate `LifecyclePolicy` objects. See the example requests in
+    #   the following section for more information.
     #
     # This operation requires permissions for the
     # `elasticfilesystem:PutLifecycleConfiguration` operation.
     #
     # To apply a `LifecycleConfiguration` object to an encrypted file
-    # system, you need the same AWS Key Management Service (AWS KMS)
-    # permissions as when you created the encrypted file system.
+    # system, you need the same Key Management Service permissions as when
+    # you created the encrypted file system.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html
     #
     # @option params [required, String] :file_system_id
     #   The ID of the file system for which you are creating the
@@ -2124,8 +2188,23 @@ module Aws::EFS
     # @option params [required, Array<Types::LifecyclePolicy>] :lifecycle_policies
     #   An array of `LifecyclePolicy` objects that define the file system's
     #   `LifecycleConfiguration` object. A `LifecycleConfiguration` object
-    #   tells lifecycle management when to transition files from the Standard
-    #   storage class to the Infrequent Access storage class.
+    #   informs EFS lifecycle management and intelligent tiering of the
+    #   following:
+    #
+    #   * When to move files in the file system from primary storage to the IA
+    #     storage class.
+    #
+    #   * When to move files that are in IA storage to primary storage.
+    #
+    #   <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
+    #   `PutLifecycleConfiguration` API action, Amazon EFS requires that each
+    #   `LifecyclePolicy` object have only a single transition. This means
+    #   that in a request body, `LifecyclePolicies` needs to be structured as
+    #   an array of `LifecyclePolicy` objects, one object for each transition,
+    #   `TransitionToIA`, `TransitionToPrimaryStorageClass`. See the example
+    #   requests in the following section for more information.
+    #
+    #    </note>
     #
     # @return [Types::LifecycleConfigurationDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2163,6 +2242,7 @@ module Aws::EFS
     #     lifecycle_policies: [ # required
     #       {
     #         transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS
+    #         transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
     #       },
     #     ],
     #   })
@@ -2171,6 +2251,7 @@ module Aws::EFS
     #
     #   resp.lifecycle_policies #=> Array
     #   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"
+    #   resp.lifecycle_policies[0].transition_to_primary_storage_class #=> String, one of "AFTER_1_ACCESS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutLifecycleConfiguration AWS API Documentation
     #
@@ -2343,7 +2424,7 @@ module Aws::EFS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-efs'
-      context[:gem_version] = '1.42.0'
+      context[:gem_version] = '1.46.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-efs/client_api.rb

@@ -141,6 +141,7 @@ module Aws::EFS
     Token = Shapes::StringShape.new(name: 'Token')
     TooManyRequests = Shapes::StructureShape.new(name: 'TooManyRequests')
     TransitionToIARules = Shapes::StringShape.new(name: 'TransitionToIARules')
+    TransitionToPrimaryStorageClassRules = Shapes::StringShape.new(name: 'TransitionToPrimaryStorageClassRules')
     Uid = Shapes::IntegerShape.new(name: 'Uid')
     UnsupportedAvailabilityZone = Shapes::StructureShape.new(name: 'UnsupportedAvailabilityZone')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
@@ -386,6 +387,7 @@ module Aws::EFS
     LifecyclePolicies.member = Shapes::ShapeRef.new(shape: LifecyclePolicy)
 
     LifecyclePolicy.add_member(:transition_to_ia, Shapes::ShapeRef.new(shape: TransitionToIARules, location_name: "TransitionToIA"))
+    LifecyclePolicy.add_member(:transition_to_primary_storage_class, Shapes::ShapeRef.new(shape: TransitionToPrimaryStorageClassRules, location_name: "TransitionToPrimaryStorageClass"))
     LifecyclePolicy.struct_class = Types::LifecyclePolicy
 
     ListTagsForResourceRequest.add_member(:resource_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location: "uri", location_name: "ResourceId"))
@@ -819,6 +821,7 @@ module Aws::EFS
         o.http_request_uri = "/2015-02-01/account-preferences"
         o.input = Shapes::ShapeRef.new(shape: PutAccountPreferencesRequest)
         o.output = Shapes::ShapeRef.new(shape: PutAccountPreferencesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BadRequest)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
       end)
 

data/lib/aws-sdk-efs/types.rb

@@ -73,7 +73,8 @@ module Aws::EFS
     #   @return [Types::RootDirectory]
     #
     # @!attribute [rw] owner_id
-    #   Identified the AWS account that owns the access point resource.
+    #   Identified the Amazon Web Services account that owns the access
+    #   point resource.
     #   @return [String]
     #
     # @!attribute [rw] life_cycle_state
@@ -97,8 +98,8 @@ module Aws::EFS
       include Aws::Structure
     end
 
-    # Returned if the AWS account has already created the maximum number of
-    # access points allowed per file system.
+    # Returned if the Amazon Web Services account has already created the
+    # maximum number of access points allowed per file system.
     #
     # @!attribute [rw] error_code
     #   @return [String]
@@ -116,7 +117,7 @@ module Aws::EFS
     end
 
     # Returned if the specified `AccessPointId` value doesn't exist in the
-    # requester's AWS account.
+    # requester's Amazon Web Services account.
     #
     # @!attribute [rw] error_code
     #   @return [String]
@@ -265,7 +266,13 @@ module Aws::EFS
     #
     # @!attribute [rw] tags
     #   Creates tags associated with the access point. Each tag is a
-    #   key-value pair.
+    #   key-value pair, each key must be unique. For more information, see
+    #   [Tagging Amazon Web Services resources][1] in the *Amazon Web
+    #   Services General Reference Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] file_system_id
@@ -353,19 +360,19 @@ module Aws::EFS
     # @!attribute [rw] encrypted
     #   A Boolean value that, if true, creates an encrypted file system.
     #   When creating an encrypted file system, you have the option of
-    #   specifying CreateFileSystemRequest$KmsKeyId for an existing AWS Key
-    #   Management Service (AWS KMS) customer master key (CMK). If you
-    #   don't specify a CMK, then the default CMK for Amazon EFS,
+    #   specifying CreateFileSystemRequest$KmsKeyId for an existing Key
+    #   Management Service (KMS customer master key (CMK). If you don't
+    #   specify a CMK, then the default CMK for Amazon EFS,
     #   `/aws/elasticfilesystem`, is used to protect the encrypted file
     #   system.
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   The ID of the AWS KMS CMK that you want to use to protect the
-    #   encrypted file system. This parameter is only required if you want
-    #   to use a non-default KMS key. If this parameter is not specified,
-    #   the default CMK for Amazon EFS is used. This ID can be in one of the
-    #   following formats:
+    #   The ID of the KMS CMK that you want to use to protect the encrypted
+    #   file system. This parameter is only required if you want to use a
+    #   non-default KMS key. If this parameter is not specified, the default
+    #   CMK for Amazon EFS is used. This ID can be in one of the following
+    #   formats:
     #
     #   * Key ID - A unique identifier of the key, for example
     #     `1234abcd-12ab-34cd-56ef-1234567890ab`.
@@ -408,9 +415,9 @@ module Aws::EFS
     #   The throughput, measured in MiB/s, that you want to provision for a
     #   file system that you're creating. Valid values are 1-1024. Required
     #   if `ThroughputMode` is set to `provisioned`. The upper limit for
-    #   throughput is 1024 MiB/s. To increase this limit, contact AWS
-    #   Support. For more information, see [Amazon EFS quotas that you can
-    #   increase][1] in the *Amazon EFS User Guide*.
+    #   throughput is 1024 MiB/s. To increase this limit, contact Amazon Web
+    #   Services Support. For more information, see [Amazon EFS quotas that
+    #   you can increase][1] in the *Amazon EFS User Guide*.
     #
     #
     #
@@ -419,13 +426,14 @@ module Aws::EFS
     #
     # @!attribute [rw] availability_zone_name
     #   Used to create a file system that uses One Zone storage classes. It
-    #   specifies the AWS Availability Zone in which to create the file
-    #   system. Use the format `us-east-1a` to specify the Availability
-    #   Zone. For more information about One Zone storage classes, see
-    #   [Using EFS storage classes][1] in the *Amazon EFS User Guide*.
+    #   specifies the Amazon Web Services Availability Zone in which to
+    #   create the file system. Use the format `us-east-1a` to specify the
+    #   Availability Zone. For more information about One Zone storage
+    #   classes, see [Using EFS storage classes][1] in the *Amazon EFS User
+    #   Guide*.
     #
     #   <note markdown="1"> One Zone storage classes are not available in all Availability Zones
-    #   in AWS Regions where Amazon EFS is available.
+    #   in Amazon Web Services Regions where Amazon EFS is available.
     #
     #    </note>
     #
@@ -445,8 +453,8 @@ module Aws::EFS
     #   Default is `false`. However, if you specify an
     #   `AvailabilityZoneName`, the default is `true`.
     #
-    #   <note markdown="1"> AWS Backup is not available in all AWS Regions where Amazon EFS is
-    #   available.
+    #   <note markdown="1"> Backup is not available in all Amazon Web Services Regionswhere
+    #   Amazon EFS is available.
     #
     #    </note>
     #
@@ -456,10 +464,16 @@ module Aws::EFS
     #   @return [Boolean]
     #
     # @!attribute [rw] tags
-    #   A value that specifies to create one or more tags associated with
-    #   the file system. Each tag is a user-defined key-value pair. Name
-    #   your file system on creation by including a
-    #   `"Key":"Name","Value":"\{value\}"` key-value pair.
+    #   Use to create one or more tags associated with the file system. Each
+    #   tag is a user-defined key-value pair. Name your file system on
+    #   creation by including a `"Key":"Name","Value":"\{value\}"` key-value
+    #   pair. Each key must be unique. For more information, see [Tagging
+    #   Amazon Web Services resources][1] in the *Amazon Web Services
+    #   General Reference Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateFileSystemRequest AWS API Documentation
@@ -793,11 +807,15 @@ module Aws::EFS
     #       }
     #
     # @!attribute [rw] next_token
-    #   Token used for pagination.
+    #   (Optional) You can use `NextToken` in a subsequent request to fetch
+    #   the next page of Amazon Web Services account preferences if the
+    #   response payload was paginated.
     #   @return [String]
     #
     # @!attribute [rw] max_results
-    #   Max results used for pagination.
+    #   (Optional) When retrieving account preferences, you can optionally
+    #   specify the `MaxItems` parameter to limit the number of objects
+    #   returned in a response. The default value is 100.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeAccountPreferencesRequest AWS API Documentation
@@ -810,10 +828,15 @@ module Aws::EFS
     end
 
     # @!attribute [rw] resource_id_preference
+    #   Describes the resource ID preference setting for the Amazon Web
+    #   Services account associated with the user making the request, in the
+    #   current Amazon Web Services Region.
     #   @return [Types::ResourceIdPreference]
     #
     # @!attribute [rw] next_token
-    #   Token used for pagination.
+    #   Present if there are more records than returned in the response. You
+    #   can use the `NextToken` in the subsequent request to fetch the
+    #   additional descriptions.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeAccountPreferencesResponse AWS API Documentation
@@ -1156,9 +1179,9 @@ module Aws::EFS
     # A description of the file system.
     #
     # @!attribute [rw] owner_id
-    #   The AWS account that created the file system. If the file system was
-    #   created by an IAM user, the parent account to which the user belongs
-    #   is the owner.
+    #   The Amazon Web Services account that created the file system. If the
+    #   file system was created by an IAM user, the parent account to which
+    #   the user belongs is the owner.
     #   @return [String]
     #
     # @!attribute [rw] creation_token
@@ -1220,8 +1243,8 @@ module Aws::EFS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   The ID of an AWS Key Management Service (AWS KMS) customer master
-    #   key (CMK) that was used to protect the encrypted file system.
+    #   The ID of an Key Management Service customer master key (CMK) that
+    #   was used to protect the encrypted file system.
     #   @return [String]
     #
     # @!attribute [rw] throughput_mode
@@ -1240,10 +1263,10 @@ module Aws::EFS
     #   @return [Float]
     #
     # @!attribute [rw] availability_zone_name
-    #   Describes the AWS Availability Zone in which the file system is
-    #   located, and is valid only for file systems using One Zone storage
-    #   classes. For more information, see [Using EFS storage classes][1] in
-    #   the *Amazon EFS User Guide*.
+    #   Describes the Amazon Web Services Availability Zone in which the
+    #   file system is located, and is valid only for file systems using One
+    #   Zone storage classes. For more information, see [Using EFS storage
+    #   classes][1] in the *Amazon EFS User Guide*.
     #
     #
     #
@@ -1253,8 +1276,9 @@ module Aws::EFS
     # @!attribute [rw] availability_zone_id
     #   The unique and consistent identifier of the Availability Zone in
     #   which the file system's One Zone storage classes exist. For
-    #   example, `use1-az1` is an Availability Zone ID for the us-east-1 AWS
-    #   Region, and it has the same location in every AWS account.
+    #   example, `use1-az1` is an Availability Zone ID for the us-east-1
+    #   Amazon Web Services Region, and it has the same location in every
+    #   Amazon Web Services account.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -1303,8 +1327,8 @@ module Aws::EFS
       include Aws::Structure
     end
 
-    # Returned if the AWS account has already created the maximum number of
-    # file systems allowed per account.
+    # Returned if the Amazon Web Services account has already created the
+    # maximum number of file systems allowed per account.
     #
     # @!attribute [rw] error_code
     #   @return [String]
@@ -1322,7 +1346,7 @@ module Aws::EFS
     end
 
     # Returned if the specified `FileSystemId` value doesn't exist in the
-    # requester's AWS account.
+    # requester's Amazon Web Services account.
     #
     # @!attribute [rw] error_code
     #   @return [String]
@@ -1512,8 +1536,8 @@ module Aws::EFS
     end
 
     # @!attribute [rw] lifecycle_policies
-    #   An array of lifecycle management policies. Currently, EFS supports a
-    #   maximum of one policy per file system.
+    #   An array of lifecycle management policies. EFS supports a maximum of
+    #   one policy per file system.
     #   @return [Array<Types::LifecyclePolicy>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/LifecycleConfigurationDescription AWS API Documentation
@@ -1524,27 +1548,52 @@ module Aws::EFS
       include Aws::Structure
     end
 
-    # Describes a policy used by EFS lifecycle management to transition
-    # files to the Infrequent Access (IA) storage class.
+    # Describes a policy used by EFS lifecycle management and EFS
+    # intelligent tiering that specifies when to transition files into and
+    # out of the file system's Infrequent Access (IA) storage class. For
+    # more information, see [EFS Intelligent‐Tiering and EFS Lifecycle
+    # Management][1].
+    #
+    # <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
+    # `PutLifecycleConfiguration` API action, Amazon EFS requires that each
+    # `LifecyclePolicy` object have only a single transition. This means
+    # that in a request body, `LifecyclePolicies` needs to be structured as
+    # an array of `LifecyclePolicy` objects, one object for each transition,
+    # `TransitionToIA`, `TransitionToPrimaryStorageClass`. For more
+    # information, see the request examples in PutLifecycleConfiguration.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html
     #
     # @note When making an API call, you may pass LifecyclePolicy
     #   data as a hash:
     #
     #       {
     #         transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS
+    #         transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
     #       }
     #
     # @!attribute [rw] transition_to_ia
-    #   A value that describes the period of time that a file is not
-    #   accessed, after which it transitions to the IA storage class.
-    #   Metadata operations such as listing the contents of a directory
-    #   don't count as file access events.
+    #   Describes the period of time that a file is not accessed, after
+    #   which it transitions to IA storage. Metadata operations such as
+    #   listing the contents of a directory don't count as file access
+    #   events.
+    #   @return [String]
+    #
+    # @!attribute [rw] transition_to_primary_storage_class
+    #   Describes when to transition a file from IA storage to primary
+    #   storage. Metadata operations such as listing the contents of a
+    #   directory don't count as file access events.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/LifecyclePolicy AWS API Documentation
     #
     class LifecyclePolicy < Struct.new(
-      :transition_to_ia)
+      :transition_to_ia,
+      :transition_to_primary_storage_class)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1650,7 +1699,7 @@ module Aws::EFS
     # Provides a description of a mount target.
     #
     # @!attribute [rw] owner_id
-    #   AWS account ID that owns the resource.
+    #   Amazon Web Services account ID that owns the resource.
     #   @return [String]
     #
     # @!attribute [rw] mount_target_id
@@ -1682,16 +1731,17 @@ module Aws::EFS
     # @!attribute [rw] availability_zone_id
     #   The unique and consistent identifier of the Availability Zone that
     #   the mount target resides in. For example, `use1-az1` is an AZ ID for
-    #   the us-east-1 Region and it has the same location in every AWS
-    #   account.
+    #   the us-east-1 Region and it has the same location in every Amazon
+    #   Web Services account.
     #   @return [String]
     #
     # @!attribute [rw] availability_zone_name
     #   The name of the Availability Zone in which the mount target is
     #   located. Availability Zones are independently mapped to names for
-    #   each AWS account. For example, the Availability Zone `us-east-1a`
-    #   for your AWS account might not be the same location as `us-east-1a`
-    #   for another AWS account.
+    #   each Amazon Web Services account. For example, the Availability Zone
+    #   `us-east-1a` for your Amazon Web Services account might not be the
+    #   same location as `us-east-1a` for another Amazon Web Services
+    #   account.
     #   @return [String]
     #
     # @!attribute [rw] vpc_id
@@ -1717,7 +1767,7 @@ module Aws::EFS
     end
 
     # Returned if there is no mount target with the specified ID found in
-    # the caller's account.
+    # the caller's Amazon Web Services account.
     #
     # @!attribute [rw] error_code
     #   @return [String]
@@ -1735,11 +1785,11 @@ module Aws::EFS
     end
 
     # The calling account has reached the limit for elastic network
-    # interfaces for the specific AWS Region. The client should try to
-    # delete some elastic network interfaces or get the account limit
-    # raised. For more information, see [Amazon VPC Limits][1] in the
-    # <i>Amazon VPC User Guide </i> (see the Network interfaces per VPC
-    # entry in the table).
+    # interfaces for the specific Amazon Web Services Region. The client
+    # should try to delete some elastic network interfaces or get the
+    # account limit raised. For more information, see [Amazon VPC Limits][1]
+    # in the <i>Amazon VPC User Guide </i> (see the Network interfaces per
+    # VPC entry in the table).
     #
     #
     #
@@ -1842,8 +1892,17 @@ module Aws::EFS
     #       }
     #
     # @!attribute [rw] resource_id_type
-    #   A preference indicating a choice to use 63bit/32bit IDs for all
-    #   applicable resources.
+    #   Specifies the EFS resource ID preference to set for the user's
+    #   Amazon Web Services account, in the current Amazon Web Services
+    #   Region, either `LONG_ID` (17 characters), or `SHORT_ID` (8
+    #   characters).
+    #
+    #   <note markdown="1"> Starting in October, 2021, you will receive an error when setting
+    #   the account preference to `SHORT_ID`. Contact Amazon Web Services
+    #   support if you receive an error and need to use short IDs for file
+    #   system and mount target resources.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutAccountPreferencesRequest AWS API Documentation
@@ -1855,6 +1914,9 @@ module Aws::EFS
     end
 
     # @!attribute [rw] resource_id_preference
+    #   Describes the resource type and its ID preference for the user's
+    #   Amazon Web Services account, in the current Amazon Web Services
+    #   Region.
     #   @return [Types::ResourceIdPreference]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutAccountPreferencesResponse AWS API Documentation
@@ -1947,6 +2009,7 @@ module Aws::EFS
     #         lifecycle_policies: [ # required
     #           {
     #             transition_to_ia: "AFTER_7_DAYS", # accepts AFTER_7_DAYS, AFTER_14_DAYS, AFTER_30_DAYS, AFTER_60_DAYS, AFTER_90_DAYS
+    #             transition_to_primary_storage_class: "AFTER_1_ACCESS", # accepts AFTER_1_ACCESS
     #           },
     #         ],
     #       }
@@ -1959,8 +2022,24 @@ module Aws::EFS
     # @!attribute [rw] lifecycle_policies
     #   An array of `LifecyclePolicy` objects that define the file system's
     #   `LifecycleConfiguration` object. A `LifecycleConfiguration` object
-    #   tells lifecycle management when to transition files from the
-    #   Standard storage class to the Infrequent Access storage class.
+    #   informs EFS lifecycle management and intelligent tiering of the
+    #   following:
+    #
+    #   * When to move files in the file system from primary storage to the
+    #     IA storage class.
+    #
+    #   * When to move files that are in IA storage to primary storage.
+    #
+    #   <note markdown="1"> When using the `put-lifecycle-configuration` CLI command or the
+    #   `PutLifecycleConfiguration` API action, Amazon EFS requires that
+    #   each `LifecyclePolicy` object have only a single transition. This
+    #   means that in a request body, `LifecyclePolicies` needs to be
+    #   structured as an array of `LifecyclePolicy` objects, one object for
+    #   each transition, `TransitionToIA`,
+    #   `TransitionToPrimaryStorageClass`. See the example requests in the
+    #   following section for more information.
+    #
+    #    </note>
     #   @return [Array<Types::LifecyclePolicy>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/PutLifecycleConfigurationRequest AWS API Documentation
@@ -1972,13 +2051,18 @@ module Aws::EFS
       include Aws::Structure
     end
 
+    # Describes the resource type and its ID preference for the user's
+    # Amazon Web Services account, in the current Amazon Web Services
+    # Region.
+    #
     # @!attribute [rw] resource_id_type
-    #   A preference indicating a choice to use 63bit/32bit IDs for all
-    #   applicable resources.
+    #   Identifies the EFS resource ID preference, either `LONG_ID` (17
+    #   characters) or `SHORT_ID` (8 characters).
     #   @return [String]
     #
     # @!attribute [rw] resources
-    #   EFS resources to which a preference applies to.
+    #   Identifies the Amazon EFS resources to which the ID preference
+    #   setting applies, `FILE_SYSTEM` and `MOUNT_TARGET`.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/ResourceIdPreference AWS API Documentation
@@ -2274,8 +2358,8 @@ module Aws::EFS
       include Aws::Structure
     end
 
-    # Returned if the AWS Backup service is not available in the Region in
-    # which the request was made.
+    # Returned if the Backup service is not available in the Amazon Web
+    # Services Region in which the request was made.
     #
     # @!attribute [rw] error_code
     #   @return [String]

data/lib/aws-sdk-efs.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-efs/customizations'
 # @!group service
 module Aws::EFS
 
-  GEM_VERSION = '1.42.0'
+  GEM_VERSION = '1.46.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-efs
 version: !ruby/object:Gem::Version
-  version: 1.42.0
+  version: 1.46.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-30 00:00:00.000000000 Z
+date: 2021-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.119.0
+        version: 3.120.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.119.0
+        version: 3.120.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -76,7 +76,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="