aws-sdk-efs 1.88.0 → 1.89.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c0a499a8387255f29d3f06b91cf5246891eb36619a9fa132fc1c82b73cc89f0
-  data.tar.gz: 699f3c410113d7661a26b2d3f8d23852c492d0d0b4a097c7adcdd76d5cf4e5b4
+  metadata.gz: 2abc8510111c054a1b5c55ad68b898228806c131d7f5da2c476d7f663e987943
+  data.tar.gz: d907533ef5d7163544ab9386eb88776a97ef6d95365f0efdb785c90294bb5ea0
 SHA512:
-  metadata.gz: dc94d487b09f3dbd7b23dec89d82c759e79755688a57e309e81d9114ce28bd36478745edc3ccb2f62289fc287545f096cff5882c2c61001d632e965b8ade8562
-  data.tar.gz: e04dee34fd5edd375ad615c0e1811403b51b921d3f1e0693397484120b182a855add306aaac04c88a6f4f0b003f6abeaed4d87c99bd3aac5cd09db44db27d9dd
+  metadata.gz: da448769b71bba8ec562139bf7b961b8aaf09dda7879a584c9c6467384953667b8c8feaab1f9b17015438cab68778681af673f988fb1c48af204279972d8ad40
+  data.tar.gz: 504e62dbe6b233778ef921969016008bcd9177a1a178fc208ec80e3d6053572c860668ca4506ab456994f43faefe9772f8273a6a8a336a12f9a4857b81abb864

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.89.0 (2024-11-19)
+------------------
+
+* Feature - Add support for the new parameters in EFS replication APIs
+
 1.88.0 (2024-11-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.88.0
+1.89.0

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

@@ -632,16 +632,13 @@ module Aws::EFS
     #
     # This operation accepts an optional `PerformanceMode` parameter that
     # you choose for your file system. We recommend `generalPurpose`
-    # performance mode for all file systems. File systems using the `maxIO`
-    # mode is a previous generation performance type that is designed for
-    # highly parallelized workloads that can tolerate higher latencies than
-    # the General Purpose mode. Max I/O mode is not supported for One Zone
-    # file systems or file systems that use Elastic throughput.
+    # `PerformanceMode` for all file systems. The `maxIO` mode is a previous
+    # generation performance type that is designed for highly parallelized
+    # workloads that can tolerate higher latencies than the `generalPurpose`
+    # mode. `MaxIO` mode is not supported for One Zone file systems or file
+    # systems that use Elastic throughput.
     #
-    # Due to the higher per-operation latencies with Max I/O, we recommend
-    # using General Purpose performance mode for all file systems.
-    #
-    # The performance mode can't be changed after the file system has been
+    # The `PerformanceMode` can't be changed after the file system has been
     # created. For more information, see [Amazon EFS performance modes][2].
     #
     # You can set the throughput mode for the file system using the
@@ -680,7 +677,7 @@ module Aws::EFS
     #   not need to pass this option.**
     #
     # @option params [String] :performance_mode
-    #   The Performance mode of the file system. We recommend `generalPurpose`
+    #   The performance mode of the file system. We recommend `generalPurpose`
     #   performance mode for all file systems. File systems using the `maxIO`
     #   performance mode can scale to higher levels of aggregate throughput
     #   and operations per second with a tradeoff of slightly higher latencies
@@ -756,11 +753,11 @@ module Aws::EFS
     #   [1]: https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits
     #
     # @option params [String] :availability_zone_name
-    #   Used to create a One Zone file system. It 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 file systems, see [Using EFS storage
-    #   classes][1] in the *Amazon EFS User Guide*.
+    #   For One Zone file systems, specify 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 file systems, see [EFS file system types][1] in the
+    #   *Amazon EFS User Guide*.
     #
     #   <note markdown="1"> One Zone file systems are not available in all Availability Zones in
     #   Amazon Web Services Regions where Amazon EFS is available.
@@ -769,7 +766,7 @@ module Aws::EFS
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html
+    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type
     #
     # @option params [Boolean] :backup
     #   Specifies whether automatic backups are enabled on the file system
@@ -1124,86 +1121,37 @@ module Aws::EFS
       req.send_request(options)
     end
 
-    # Creates a replication configuration that replicates an existing EFS
-    # file system to a new, read-only file system. For more information, see
-    # [Amazon EFS replication][1] in the *Amazon EFS User Guide*. The
-    # replication configuration specifies the following:
-    #
-    # * **Source file system** – The EFS file system that you want
-    #   replicated. The source file system cannot be a destination file
-    #   system in an existing replication configuration.
-    #
-    # * **Amazon Web Services Region** – The Amazon Web Services Region in
-    #   which the destination file system is created. Amazon EFS replication
-    #   is available in all Amazon Web Services Regions in which EFS is
-    #   available. The Region must be enabled. For more information, see
-    #   [Managing Amazon Web Services Regions][2] in the *Amazon Web
-    #   Services General Reference Reference Guide*.
-    #
-    # * **Destination file system configuration** – The configuration of the
-    #   destination file system to which the source file system will be
-    #   replicated. There can only be one destination file system in a
-    #   replication configuration.
-    #
-    #   Parameters for the replication configuration include:
-    #
-    #   * **File system ID** – The ID of the destination file system for the
-    #     replication. If no ID is provided, then EFS creates a new file
-    #     system with the default settings. For existing file systems, the
-    #     file system's replication overwrite protection must be disabled.
-    #     For more information, see [ Replicating to an existing file
-    #     system][3].
-    #
-    #   * **Availability Zone** – If you want the destination file system to
-    #     use One Zone storage, you must specify the Availability Zone to
-    #     create the file system in. For more information, see [ EFS file
-    #     system types][4] in the *Amazon EFS User Guide*.
-    #
-    #   * **Encryption** – All destination file systems are created with
-    #     encryption at rest enabled. You can specify the Key Management
-    #     Service (KMS) key that is used to encrypt the destination file
-    #     system. If you don't specify a KMS key, your service-managed KMS
-    #     key for Amazon EFS is used.
-    #
-    #     <note markdown="1"> After the file system is created, you cannot change the KMS key.
-    #
-    #      </note>
+    # Creates a replication configuration to either a new or existing EFS
+    # file system. For more information, see [Amazon EFS replication][1] in
+    # the *Amazon EFS User Guide*. The replication configuration specifies
+    # the following:
     #
-    # <note markdown="1"> After the file system is created, you cannot change the KMS key.
+    # * **Source file system** – The EFS file system that you want to
+    #   replicate.
     #
-    #  </note>
+    # * **Destination file system** – The destination file system to which
+    #   the source file system is replicated. There can only be one
+    #   destination file system in a replication configuration.
     #
-    # For new destination file systems, the following properties are set by
-    # default:
-    #
-    # * **Performance mode** - The destination file system's performance
-    #   mode matches that of the source file system, unless the destination
-    #   file system uses EFS One Zone storage. In that case, the General
-    #   Purpose performance mode is used. The performance mode cannot be
-    #   changed.
-    #
-    # * **Throughput mode** - The destination file system's throughput mode
-    #   matches that of the source file system. After the file system is
-    #   created, you can modify the throughput mode.
-    # ^
+    #   <note markdown="1"> A file system can be part of only one replication configuration.
     #
-    # * **Lifecycle management** – Lifecycle management is not enabled on
-    #   the destination file system. After the destination file system is
-    #   created, you can enable lifecycle management.
+    #    </note>
     #
-    # * **Automatic backups** – Automatic daily backups are enabled on the
-    #   destination file system. After the file system is created, you can
-    #   change this setting.
+    #   The destination parameters for the replication configuration depend
+    #   on whether you are replicating to a new file system or to an
+    #   existing file system, and if you are replicating across Amazon Web
+    #   Services accounts. See DestinationToCreate for more information.
     #
-    # For more information, see [Amazon EFS replication][1] in the *Amazon
-    # EFS User Guide*.
+    # This operation requires permissions for the
+    # `elasticfilesystem:CreateReplicationConfiguration` action.
+    # Additionally, other permissions are required depending on how you are
+    # replicating file systems. For more information, see [Required
+    # permissions for replication][2] in the *Amazon EFS User Guide*.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html
-    # [2]: https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable
-    # [3]: https://docs.aws.amazon.com/efs/latest/ug/efs-replication#replicate-existing-destination
-    # [4]: https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html
+    # [2]: https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions
     #
     # @option params [required, String] :source_file_system_id
     #   Specifies the Amazon EFS file system that you want to replicate. This
@@ -1222,6 +1170,7 @@ module Aws::EFS
     #   * {Types::ReplicationConfigurationDescription#original_source_file_system_arn #original_source_file_system_arn} => String
     #   * {Types::ReplicationConfigurationDescription#creation_time #creation_time} => Time
     #   * {Types::ReplicationConfigurationDescription#destinations #destinations} => Array&lt;Types::Destination&gt;
+    #   * {Types::ReplicationConfigurationDescription#source_file_system_owner_id #source_file_system_owner_id} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -1233,6 +1182,7 @@ module Aws::EFS
     #         availability_zone_name: "AvailabilityZoneName",
     #         kms_key_id: "KmsKeyId",
     #         file_system_id: "FileSystemId",
+    #         role_arn: "RoleArn",
     #       },
     #     ],
     #   })
@@ -1249,6 +1199,10 @@ module Aws::EFS
     #   resp.destinations[0].file_system_id #=> String
     #   resp.destinations[0].region #=> String
     #   resp.destinations[0].last_replicated_timestamp #=> Time
+    #   resp.destinations[0].owner_id #=> String
+    #   resp.destinations[0].status_message #=> String
+    #   resp.destinations[0].role_arn #=> String
+    #   resp.source_file_system_owner_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateReplicationConfiguration AWS API Documentation
     #
@@ -1357,7 +1311,7 @@ module Aws::EFS
     # you when you use the Amazon Web Services console to delete a file
     # system.
     #
-    # <note markdown="1"> You cannot delete a file system that is part of an EFS Replication
+    # <note markdown="1"> You cannot delete a file system that is part of an EFS replication
     # configuration. You need to delete the replication configuration first.
     #
     #  </note>
@@ -1518,12 +1472,35 @@ module Aws::EFS
     # @option params [required, String] :source_file_system_id
     #   The ID of the source file system in the replication configuration.
     #
+    # @option params [String] :deletion_mode
+    #   When replicating across Amazon Web Services accounts or across Amazon
+    #   Web Services Regions, Amazon EFS deletes the replication configuration
+    #   from both the source and destination account or Region
+    #   (`ALL_CONFIGURATIONS`) by default. If there's a configuration or
+    #   permissions issue that prevents Amazon EFS from deleting the
+    #   replication configuration from both sides, you can use the
+    #   `LOCAL_CONFIGURATION_ONLY` mode to delete the replication
+    #   configuration from only the local side (the account or Region from
+    #   which the delete is performed).
+    #
+    #   <note markdown="1"> Only use the `LOCAL_CONFIGURATION_ONLY` mode in the case that Amazon
+    #   EFS is unable to delete the replication configuration in both the
+    #   source and destination account or Region. Deleting the local
+    #   configuration leaves the configuration in the other account or Region
+    #   unrecoverable.
+    #
+    #    Additionally, do not use this mode for same-account, same-region
+    #   replication as doing so results in a BadRequest exception error.
+    #
+    #    </note>
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_replication_configuration({
     #     source_file_system_id: "FileSystemId", # required
+    #     deletion_mode: "ALL_CONFIGURATIONS", # accepts ALL_CONFIGURATIONS, LOCAL_CONFIGURATION_ONLY
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration AWS API Documentation
@@ -2131,7 +2108,9 @@ module Aws::EFS
     #
     # @option params [String] :file_system_id
     #   You can retrieve the replication configuration for a specific file
-    #   system by providing its file system ID.
+    #   system by providing its file system ID. For cross-account,cross-region
+    #   replication, an account can only describe the replication
+    #   configuration for a file system in its own Region.
     #
     # @option params [String] :next_token
     #   `NextToken` is present if the response is paginated. You can use
@@ -2169,6 +2148,10 @@ module Aws::EFS
     #   resp.replications[0].destinations[0].file_system_id #=> String
     #   resp.replications[0].destinations[0].region #=> String
     #   resp.replications[0].destinations[0].last_replicated_timestamp #=> Time
+    #   resp.replications[0].destinations[0].owner_id #=> String
+    #   resp.replications[0].destinations[0].status_message #=> String
+    #   resp.replications[0].destinations[0].role_arn #=> String
+    #   resp.replications[0].source_file_system_owner_id #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations AWS API Documentation
@@ -2463,7 +2446,7 @@ module Aws::EFS
     # set or updated using this API operation. EFS file system policies have
     # a 20,000 character limit. When an explicit policy is set, it overrides
     # the default policy. For more information about the default file system
-    # policy, see [Default EFS File System Policy][1].
+    # policy, see [ Default EFS file system policy][1].
     #
     # <note markdown="1"> EFS file system policies have a 20,000 character limit.
     #
@@ -2484,11 +2467,11 @@ module Aws::EFS
     #   The `FileSystemPolicy` that you're creating. Accepts a JSON formatted
     #   policy definition. EFS file system policies have a 20,000 character
     #   limit. To find out more about the elements that make up a file system
-    #   policy, see [EFS Resource-based Policies][1].
+    #   policy, see [Resource-based policies within Amazon EFS][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/access-control-overview.html#access-control-manage-access-intro-resource-policies
+    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies
     #
     # @option params [Boolean] :bypass_policy_lockout_safety_check
     #   (Optional) A boolean that specifies whether or not to bypass the
@@ -2545,7 +2528,7 @@ module Aws::EFS
     #   either not be set or must be later than TransitionToIA.
     #
     #   <note markdown="1"> The Archive storage class is available only for file systems that
-    #   use the Elastic Throughput mode and the General Purpose Performance
+    #   use the Elastic throughput mode and the General Purpose performance
     #   mode.
     #
     #    </note>
@@ -2568,7 +2551,7 @@ module Aws::EFS
     # `LifecycleConfiguration`. In the request, specify the following:
     #
     # * The ID for the file system for which you are enabling, disabling, or
-    #   modifying Lifecycle management.
+    #   modifying lifecycle management.
     #
     # * A `LifecyclePolicies` array of `LifecyclePolicy` objects that define
     #   when to move files to IA storage, to Archive storage, and back to
@@ -2599,7 +2582,7 @@ 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
-    #   informs EFS Lifecycle management of the following:
+    #   informs lifecycle management of the following:
     #
     #   * <b> <code>TransitionToIA</code> </b> – When to move files in the
     #     file system from primary storage (Standard storage class) into the
@@ -2614,7 +2597,7 @@ module Aws::EFS
     #     either not be set or must be later than TransitionToIA.
     #
     #     <note markdown="1"> The Archive storage class is available only for file systems that
-    #     use the Elastic Throughput mode and the General Purpose Performance
+    #     use the Elastic throughput mode and the General Purpose performance
     #     mode.
     #
     #      </note>
@@ -2873,7 +2856,7 @@ module Aws::EFS
     #     read-only and is only modified only by EFS replication.
     #
     #   If the replication configuration is deleted, the file system's
-    #   replication overwrite protection is re-enabled, the file system
+    #   replication overwrite protection is re-enabled and the file system
     #   becomes writeable.
     #
     # @return [Types::FileSystemProtectionDescription] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2918,7 +2901,7 @@ module Aws::EFS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-efs'
-      context[:gem_version] = '1.88.0'
+      context[:gem_version] = '1.89.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -45,6 +45,7 @@ module Aws::EFS
     DeleteMountTargetRequest = Shapes::StructureShape.new(name: 'DeleteMountTargetRequest')
     DeleteReplicationConfigurationRequest = Shapes::StructureShape.new(name: 'DeleteReplicationConfigurationRequest')
     DeleteTagsRequest = Shapes::StructureShape.new(name: 'DeleteTagsRequest')
+    DeletionMode = Shapes::StringShape.new(name: 'DeletionMode')
     DependencyTimeout = Shapes::StructureShape.new(name: 'DependencyTimeout')
     DescribeAccessPointsRequest = Shapes::StructureShape.new(name: 'DescribeAccessPointsRequest')
     DescribeAccessPointsResponse = Shapes::StructureShape.new(name: 'DescribeAccessPointsResponse')
@@ -138,6 +139,7 @@ module Aws::EFS
     ResourceIdPreference = Shapes::StructureShape.new(name: 'ResourceIdPreference')
     ResourceIdType = Shapes::StringShape.new(name: 'ResourceIdType')
     Resources = Shapes::ListShape.new(name: 'Resources')
+    RoleArn = Shapes::StringShape.new(name: 'RoleArn')
     RootDirectory = Shapes::StructureShape.new(name: 'RootDirectory')
     SecondaryGids = Shapes::ListShape.new(name: 'SecondaryGids')
     SecurityGroup = Shapes::StringShape.new(name: 'SecurityGroup')
@@ -145,6 +147,7 @@ module Aws::EFS
     SecurityGroupNotFound = Shapes::StructureShape.new(name: 'SecurityGroupNotFound')
     SecurityGroups = Shapes::ListShape.new(name: 'SecurityGroups')
     Status = Shapes::StringShape.new(name: 'Status')
+    StatusMessage = Shapes::StringShape.new(name: 'StatusMessage')
     SubnetId = Shapes::StringShape.new(name: 'SubnetId')
     SubnetNotFound = Shapes::StructureShape.new(name: 'SubnetNotFound')
     Tag = Shapes::StructureShape.new(name: 'Tag')
@@ -265,6 +268,7 @@ module Aws::EFS
     DeleteMountTargetRequest.struct_class = Types::DeleteMountTargetRequest
 
     DeleteReplicationConfigurationRequest.add_member(:source_file_system_id, Shapes::ShapeRef.new(shape: FileSystemId, required: true, location: "uri", location_name: "SourceFileSystemId"))
+    DeleteReplicationConfigurationRequest.add_member(:deletion_mode, Shapes::ShapeRef.new(shape: DeletionMode, location: "querystring", location_name: "deletionMode"))
     DeleteReplicationConfigurationRequest.struct_class = Types::DeleteReplicationConfigurationRequest
 
     DeleteTagsRequest.add_member(:file_system_id, Shapes::ShapeRef.new(shape: FileSystemId, required: true, location: "uri", location_name: "FileSystemId"))
@@ -354,12 +358,16 @@ module Aws::EFS
     Destination.add_member(:file_system_id, Shapes::ShapeRef.new(shape: FileSystemId, required: true, location_name: "FileSystemId"))
     Destination.add_member(:region, Shapes::ShapeRef.new(shape: RegionName, required: true, location_name: "Region"))
     Destination.add_member(:last_replicated_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastReplicatedTimestamp"))
+    Destination.add_member(:owner_id, Shapes::ShapeRef.new(shape: AwsAccountId, location_name: "OwnerId"))
+    Destination.add_member(:status_message, Shapes::ShapeRef.new(shape: StatusMessage, location_name: "StatusMessage"))
+    Destination.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "RoleArn"))
     Destination.struct_class = Types::Destination
 
     DestinationToCreate.add_member(:region, Shapes::ShapeRef.new(shape: RegionName, location_name: "Region"))
     DestinationToCreate.add_member(:availability_zone_name, Shapes::ShapeRef.new(shape: AvailabilityZoneName, location_name: "AvailabilityZoneName"))
     DestinationToCreate.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "KmsKeyId"))
     DestinationToCreate.add_member(:file_system_id, Shapes::ShapeRef.new(shape: FileSystemId, location_name: "FileSystemId"))
+    DestinationToCreate.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "RoleArn"))
     DestinationToCreate.struct_class = Types::DestinationToCreate
 
     Destinations.member = Shapes::ShapeRef.new(shape: Destination)
@@ -534,6 +542,7 @@ module Aws::EFS
     ReplicationConfigurationDescription.add_member(:original_source_file_system_arn, Shapes::ShapeRef.new(shape: FileSystemArn, required: true, location_name: "OriginalSourceFileSystemArn"))
     ReplicationConfigurationDescription.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreationTime"))
     ReplicationConfigurationDescription.add_member(:destinations, Shapes::ShapeRef.new(shape: Destinations, required: true, location_name: "Destinations"))
+    ReplicationConfigurationDescription.add_member(:source_file_system_owner_id, Shapes::ShapeRef.new(shape: AwsAccountId, location_name: "SourceFileSystemOwnerId"))
     ReplicationConfigurationDescription.struct_class = Types::ReplicationConfigurationDescription
 
     ReplicationConfigurationDescriptions.member = Shapes::ShapeRef.new(shape: ReplicationConfigurationDescription)

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

@@ -373,7 +373,7 @@ module Aws::EFS
     #   @return [String]
     #
     # @!attribute [rw] performance_mode
-    #   The Performance mode of the file system. We recommend
+    #   The performance mode of the file system. We recommend
     #   `generalPurpose` performance mode for all file systems. File systems
     #   using the `maxIO` performance mode can scale to higher levels of
     #   aggregate throughput and operations per second with a tradeoff of
@@ -454,11 +454,11 @@ module Aws::EFS
     #   @return [Float]
     #
     # @!attribute [rw] availability_zone_name
-    #   Used to create a One Zone file system. It 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 file systems, see [Using EFS storage
-    #   classes][1] in the *Amazon EFS User Guide*.
+    #   For One Zone file systems, specify 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 file systems, see [EFS file system types][1] in the
+    #   *Amazon EFS User Guide*.
     #
     #   <note markdown="1"> One Zone file systems are not available in all Availability Zones in
     #   Amazon Web Services Regions where Amazon EFS is available.
@@ -467,7 +467,7 @@ module Aws::EFS
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html
+    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type
     #   @return [String]
     #
     # @!attribute [rw] backup
@@ -683,10 +683,34 @@ module Aws::EFS
     #   The ID of the source file system in the replication configuration.
     #   @return [String]
     #
+    # @!attribute [rw] deletion_mode
+    #   When replicating across Amazon Web Services accounts or across
+    #   Amazon Web Services Regions, Amazon EFS deletes the replication
+    #   configuration from both the source and destination account or Region
+    #   (`ALL_CONFIGURATIONS`) by default. If there's a configuration or
+    #   permissions issue that prevents Amazon EFS from deleting the
+    #   replication configuration from both sides, you can use the
+    #   `LOCAL_CONFIGURATION_ONLY` mode to delete the replication
+    #   configuration from only the local side (the account or Region from
+    #   which the delete is performed).
+    #
+    #   <note markdown="1"> Only use the `LOCAL_CONFIGURATION_ONLY` mode in the case that Amazon
+    #   EFS is unable to delete the replication configuration in both the
+    #   source and destination account or Region. Deleting the local
+    #   configuration leaves the configuration in the other account or
+    #   Region unrecoverable.
+    #
+    #    Additionally, do not use this mode for same-account, same-region
+    #   replication as doing so results in a BadRequest exception error.
+    #
+    #    </note>
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteReplicationConfigurationRequest AWS API Documentation
     #
     class DeleteReplicationConfigurationRequest < Struct.new(
-      :source_file_system_id)
+      :source_file_system_id,
+      :deletion_mode)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1028,7 +1052,9 @@ module Aws::EFS
 
     # @!attribute [rw] file_system_id
     #   You can retrieve the replication configuration for a specific file
-    #   system by providing its file system ID.
+    #   system by providing its file system ID. For
+    #   cross-account,cross-region replication, an account can only describe
+    #   the replication configuration for a file system in its own Region.
     #   @return [String]
     #
     # @!attribute [rw] next_token
@@ -1128,27 +1154,13 @@ module Aws::EFS
     # configuration.
     #
     # @!attribute [rw] status
-    #   Describes the status of the destination EFS file system.
+    #   Describes the status of the replication configuration. For more
+    #   information about replication status, see [Viewing replication
+    #   details][1] in the *Amazon EFS User Guide*.
     #
-    #   * The `Paused` state occurs as a result of opting out of the source
-    #     or destination Region after the replication configuration was
-    #     created. To resume replication for the file system, you need to
-    #     again opt in to the Amazon Web Services Region. For more
-    #     information, see [Managing Amazon Web Services Regions][1] in the
-    #     *Amazon Web Services General Reference Guide*.
     #
-    #   * The `Error` state occurs when either the source or the destination
-    #     file system (or both) is in a failed state and is unrecoverable.
-    #     For more information, see [Monitoring replication status][2] in
-    #     the *Amazon EFS User Guide*. You must delete the replication
-    #     configuration, and then restore the most recent backup of the
-    #     failed file system (either the source or the destination) to a new
-    #     file system.
     #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable
-    #   [2]: https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#restoring-backup-efsmonitoring-replication-status.html
+    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#restoring-backup-efsmonitoring-replication-status.html
     #   @return [String]
     #
     # @!attribute [rw] file_system_id
@@ -1168,13 +1180,39 @@ module Aws::EFS
     #   after this time might not be fully replicated.
     #   @return [Time]
     #
+    # @!attribute [rw] owner_id
+    #   ID of the Amazon Web Services account in which the destination file
+    #   system resides.
+    #   @return [String]
+    #
+    # @!attribute [rw] status_message
+    #   Message that provides details about the `PAUSED` or `ERRROR` state
+    #   of the replication destination configuration. For more information
+    #   about replication status messages, see [Viewing replication
+    #   details][1] in the *Amazon EFS User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#restoring-backup-efsmonitoring-replication-status.html
+    #   @return [String]
+    #
+    # @!attribute [rw] role_arn
+    #   Amazon Resource Name (ARN) of the IAM role in the source account
+    #   that allows Amazon EFS to perform replication on its behalf. This is
+    #   optional for same-account replication and required for cross-account
+    #   replication.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/Destination AWS API Documentation
     #
     class Destination < Struct.new(
       :status,
       :file_system_id,
       :region,
-      :last_replicated_timestamp)
+      :last_replicated_timestamp,
+      :owner_id,
+      :status_message,
+      :role_arn)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1182,10 +1220,52 @@ module Aws::EFS
     # Describes the new or existing destination file system for the
     # replication configuration.
     #
+    # * If you want to replicate to a new file system, do not specify the
+    #   File System ID for the destination file system. Amazon EFS creates a
+    #   new, empty file system. For One Zone storage, specify the
+    #   Availability Zone to create the file system in. To use an Key
+    #   Management Service key other than the default KMS key, then specify
+    #   it. For more information, see [Configuring replication to new Amazon
+    #   EFS file system][1] in the *Amazon EFS User Guide*.
+    #
+    #   <note markdown="1"> After the file system is created, you cannot change the KMS key or
+    #   the performance mode.
+    #
+    #    </note>
+    #
+    # * If you want to replicate to an existing file system that's in the
+    #   same account as the source file system, then you need to provide the
+    #   ID or Amazon Resource Name (ARN) of the file system to which to
+    #   replicate. The file system's replication overwrite protection must
+    #   be disabled. For more information, see [Replicating to an existing
+    #   file system][2] in the *Amazon EFS User Guide*.
+    #
+    # * If you are replicating the file system to a file system that's in a
+    #   different account than the source file system (cross-account
+    #   replication), you need to provide the ARN for the file system and
+    #   the IAM role that allows Amazon EFS to perform replication on the
+    #   destination account. The file system's replication overwrite
+    #   protection must be disabled. For more information, see [Replicating
+    #   across Amazon Web Services accounts][3] in the *Amazon EFS User
+    #   Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/efs/latest/ug/create-replication.html
+    # [2]: https://docs.aws.amazon.com/efs/latest/ug/efs-replication#replicate-existing-destination
+    # [3]: https://docs.aws.amazon.com/efs/latest/ug/cross-account-replication.html
+    #
     # @!attribute [rw] region
     #   To create a file system that uses Regional storage, specify the
     #   Amazon Web Services Region in which to create the destination file
-    #   system.
+    #   system. The Region must be enabled for the Amazon Web Services
+    #   account that owns the source file system. For more information, see
+    #   [Managing Amazon Web Services Regions][1] in the *Amazon Web
+    #   Services General Reference Reference Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable
     #   @return [String]
     #
     # @!attribute [rw] availability_zone_name
@@ -1204,7 +1284,7 @@ module Aws::EFS
     #   * Key ID - The unique identifier of the key, for example
     #     `1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
-    #   * ARN - The Amazon Resource Name (ARN) for the key, for example
+    #   * ARN - The ARN for the key, for example
     #     `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
     #   * Key alias - A previously created display name for a key, for
@@ -1215,10 +1295,17 @@ module Aws::EFS
     #   @return [String]
     #
     # @!attribute [rw] file_system_id
-    #   The ID of the file system to use for the destination. The file
-    #   system's replication overwrite replication must be disabled. If you
-    #   do not provide an ID, then EFS creates a new file system for the
-    #   replication destination.
+    #   The ID or ARN of the file system to use for the destination. For
+    #   cross-account replication, this must be an ARN. The file system's
+    #   replication overwrite replication must be disabled. If no ID or ARN
+    #   is specified, then a new file system is created.
+    #   @return [String]
+    #
+    # @!attribute [rw] role_arn
+    #   Amazon Resource Name (ARN) of the IAM role in the source account
+    #   that allows Amazon EFS to perform replication on its behalf. This is
+    #   optional for same-account replication and required for cross-account
+    #   replication.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DestinationToCreate AWS API Documentation
@@ -1227,7 +1314,8 @@ module Aws::EFS
       :region,
       :availability_zone_name,
       :kms_key_id,
-      :file_system_id)
+      :file_system_id,
+      :role_arn)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1320,7 +1408,7 @@ module Aws::EFS
     #   @return [Types::FileSystemSize]
     #
     # @!attribute [rw] performance_mode
-    #   The Performance mode of the file system.
+    #   The performance mode of the file system.
     #   @return [String]
     #
     # @!attribute [rw] encrypted
@@ -1765,7 +1853,7 @@ module Aws::EFS
       include Aws::Structure
     end
 
-    # Describes a policy used by Lifecycle management that specifies when to
+    # Describes a policy used by lifecycle management that specifies when to
     # transition files into and out of storage classes. For more
     # information, see [Managing file system storage][1].
     #
@@ -1799,7 +1887,7 @@ module Aws::EFS
     #
     # @!attribute [rw] transition_to_archive
     #   The number of days after files were last accessed in primary storage
-    #   (the Standard storage class) files at which to move them to Archive
+    #   (the Standard storage class) at which to move them to Archive
     #   storage. Metadata operations such as listing the contents of a
     #   directory don't count as file access events.
     #   @return [String]
@@ -2186,11 +2274,12 @@ module Aws::EFS
     #   The `FileSystemPolicy` that you're creating. Accepts a JSON
     #   formatted policy definition. EFS file system policies have a 20,000
     #   character limit. To find out more about the elements that make up a
-    #   file system policy, see [EFS Resource-based Policies][1].
+    #   file system policy, see [Resource-based policies within Amazon
+    #   EFS][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/access-control-overview.html#access-control-manage-access-intro-resource-policies
+    #   [1]: https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies
     #   @return [String]
     #
     # @!attribute [rw] bypass_policy_lockout_safety_check
@@ -2223,7 +2312,7 @@ module Aws::EFS
     # @!attribute [rw] lifecycle_policies
     #   An array of `LifecyclePolicy` objects that define the file system's
     #   `LifecycleConfiguration` object. A `LifecycleConfiguration` object
-    #   informs EFS Lifecycle management of the following:
+    #   informs lifecycle management of the following:
     #
     #   * <b> <code>TransitionToIA</code> </b> – When to move files in the
     #     file system from primary storage (Standard storage class) into the
@@ -2238,8 +2327,8 @@ module Aws::EFS
     #     either not be set or must be later than TransitionToIA.
     #
     #     <note markdown="1"> The Archive storage class is available only for file systems that
-    #     use the Elastic Throughput mode and the General Purpose
-    #     Performance mode.
+    #     use the Elastic throughput mode and the General Purpose
+    #     performance mode.
     #
     #      </note>
     #
@@ -2326,6 +2415,11 @@ module Aws::EFS
     #   supported.
     #   @return [Array<Types::Destination>]
     #
+    # @!attribute [rw] source_file_system_owner_id
+    #   ID of the Amazon Web Services account in which the source file
+    #   system resides.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/ReplicationConfigurationDescription AWS API Documentation
     #
     class ReplicationConfigurationDescription < Struct.new(
@@ -2334,7 +2428,8 @@ module Aws::EFS
       :source_file_system_arn,
       :original_source_file_system_arn,
       :creation_time,
-      :destinations)
+      :destinations,
+      :source_file_system_owner_id)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2392,7 +2487,7 @@ module Aws::EFS
     # point provides access to. The access point exposes the specified file
     # system path as the root directory of your file system to applications
     # using the access point. NFS clients using the access point can only
-    # access data in the access point's `RootDirectory` and it's
+    # access data in the access point's `RootDirectory` and its
     # subdirectories.
     #
     # @!attribute [rw] path
@@ -2706,7 +2801,7 @@ module Aws::EFS
     #     read-only and is only modified only by EFS replication.
     #
     #   If the replication configuration is deleted, the file system's
-    #   replication overwrite protection is re-enabled, the file system
+    #   replication overwrite protection is re-enabled and the file system
     #   becomes writeable.
     #   @return [String]
     #

data/lib/aws-sdk-efs.rb

@@ -54,7 +54,7 @@ module Aws::EFS
   autoload :EndpointProvider, 'aws-sdk-efs/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-efs/endpoints'
 
-  GEM_VERSION = '1.88.0'
+  GEM_VERSION = '1.89.0'
 
 end
 

data/sig/client.rbs

@@ -184,6 +184,7 @@ module Aws
         def original_source_file_system_arn: () -> ::String
         def creation_time: () -> ::Time
         def destinations: () -> ::Array[Types::Destination]
+        def source_file_system_owner_id: () -> ::String
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EFS/Client.html#create_replication_configuration-instance_method
       def create_replication_configuration: (
@@ -193,7 +194,8 @@ module Aws
                                                   region: ::String?,
                                                   availability_zone_name: ::String?,
                                                   kms_key_id: ::String?,
-                                                  file_system_id: ::String?
+                                                  file_system_id: ::String?,
+                                                  role_arn: ::String?
                                                 },
                                               ]
                                             ) -> _CreateReplicationConfigurationResponseSuccess
@@ -237,7 +239,8 @@ module Aws
 
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EFS/Client.html#delete_replication_configuration-instance_method
       def delete_replication_configuration: (
-                                              source_file_system_id: ::String
+                                              source_file_system_id: ::String,
+                                              ?deletion_mode: ("ALL_CONFIGURATIONS" | "LOCAL_CONFIGURATION_ONLY")
                                             ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
                                           | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
 

data/sig/types.rbs

@@ -140,6 +140,7 @@ module Aws::EFS
 
     class DeleteReplicationConfigurationRequest
       attr_accessor source_file_system_id: ::String
+      attr_accessor deletion_mode: ("ALL_CONFIGURATIONS" | "LOCAL_CONFIGURATION_ONLY")
       SENSITIVE: []
     end
 
@@ -269,6 +270,9 @@ module Aws::EFS
       attr_accessor file_system_id: ::String
       attr_accessor region: ::String
       attr_accessor last_replicated_timestamp: ::Time
+      attr_accessor owner_id: ::String
+      attr_accessor status_message: ::String
+      attr_accessor role_arn: ::String
       SENSITIVE: []
     end
 
@@ -277,6 +281,7 @@ module Aws::EFS
       attr_accessor availability_zone_name: ::String
       attr_accessor kms_key_id: ::String
       attr_accessor file_system_id: ::String
+      attr_accessor role_arn: ::String
       SENSITIVE: []
     end
 
@@ -507,6 +512,7 @@ module Aws::EFS
       attr_accessor original_source_file_system_arn: ::String
       attr_accessor creation_time: ::Time
       attr_accessor destinations: ::Array[Types::Destination]
+      attr_accessor source_file_system_owner_id: ::String
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-efs
 version: !ruby/object:Gem::Version
-  version: 1.88.0
+  version: 1.89.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-18 00:00:00.000000000 Z
+date: 2024-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core