aws-sdk-efs 1.45.0 → 1.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc15e83e12a1b714a643c97a5f63b77ea3de8a637393b00cc853925aa42a9f30
-  data.tar.gz: 7e82e1d94c818067181f0fa656ef3d31e35247f5099ec6812fcde971d022a346
+  metadata.gz: 8df0fca04850c2de03da3be698676a6a7efda52ca1bc83896c60687f954d7dc3
+  data.tar.gz: 0c75c0947ee46a8d9d11730aaf93dca6ecc7d314c4b25087d1b73c92de076ffa
 SHA512:
-  metadata.gz: 8b0b04b7a5499feb37ccb166ec1189668f7b9243feb8514538d6f2d32f6443e2d4472c64a1b8b82fc05a547215d23dc06218e2ad05045ba1d0371d43cc7596c4
-  data.tar.gz: 9b9cce539b362c78f430b3df95fc3bce707ea23934bcf8a59043f24750ecba37d8fbbe08cbf74db94821b9660a4bcbea0014fd5973641874b96fa1fd4d6e5046
+  metadata.gz: 70dc2e6ab72150e405f00db84e764ba1e071769c78eb5815279dfa3b3588bcd57302fa2afe24f3015e1eaadfce061e337e765f27a6a494bac2047c03060cfa0a
+  data.tar.gz: 59966dd281e3b7dbf15ca7422e978e0afc0ee6fd2669caf7dc4b8c484193fdc8365a005fdee42070aeec491f7c50a38088af5515bcd7aecad76dcb0b9510a382

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.45.0
+1.46.0

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

@@ -1979,18 +1979,36 @@ module Aws::EFS
     end
 
     # Use this operation to set the account preference in the current Amazon
-    # Web Services Region to use either long 17 character (63 bit) or short
-    # 8 character (32 bit) IDs for new EFS file systems and mount targets
-    # created. 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](efs/latest/ug/manage-efs-resource-ids.html).
+    # 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
     #   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:
     #
     #   * {Types::PutAccountPreferencesResponse#resource_id_preference #resource_id_preference} => Types::ResourceIdPreference
@@ -2060,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.
@@ -2129,15 +2149,14 @@ module Aws::EFS
     # `TransitionToPrimaryStorageClass` to `AFTER_1_ACCESS`. For more
     # information, see [EFS Lifecycle Management][1].
     #
-    # A `LifecycleConfiguration` applies to all files in a file system.
-    #
     # Each Amazon EFS file system supports one lifecycle configuration,
     # which applies to all files in the file system. If a
     # `LifecycleConfiguration` object already exists for the specified file
     # 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:
     #
@@ -2145,8 +2164,11 @@ 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.
@@ -2166,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:
     #
@@ -2387,7 +2424,7 @@ module Aws::EFS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-efs'
-      context[:gem_version] = '1.45.0'
+      context[:gem_version] = '1.46.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1548,8 +1548,25 @@ 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:
@@ -1561,14 +1578,15 @@ module Aws::EFS
     #
     # @!attribute [rw] transition_to_ia
     #   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.
+    #   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 the policy used to transition a file from infequent access
-    #   storage to primary storage.
+    #   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
@@ -1878,6 +1896,13 @@ module Aws::EFS
     #   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
@@ -1997,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

data/lib/aws-sdk-efs.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-efs/customizations'
 # @!group service
 module Aws::EFS
 
-  GEM_VERSION = '1.45.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.45.0
+  version: 1.46.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-04 00:00:00.000000000 Z
+date: 2021-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core