AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Creates a replication configuration to either a new or existing EFS file system. For more information, see Amazon EFS replication in the Amazon EFS User Guide. The replication configuration specifies the following:
Source file system – The EFS file system that you want to replicate.
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.
A file system can be part of only one replication configuration.
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.
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 in the Amazon EFS User Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to CreateReplicationConfigurationAsync.
Namespace: Amazon.ElasticFileSystem
Assembly: AWSSDK.ElasticFileSystem.dll
Version: 3.x.y.z
public virtual CreateReplicationConfigurationResponse CreateReplicationConfiguration( CreateReplicationConfigurationRequest request )
Container for the necessary parameters to execute the CreateReplicationConfiguration service method.
| Exception | Condition |
|---|---|
| BadRequestException | Returned if the request is malformed or contains an error such as an invalid parameter value or a missing required parameter. |
| ConflictException | Returned if the source file system in a replication is encrypted but the destination file system is unencrypted. |
| FileSystemLimitExceededException | Returned if the Amazon Web Services account has already created the maximum number of file systems allowed per account. |
| FileSystemNotFoundException | Returned if the specified FileSystemId value doesn't exist in the requester's Amazon Web Services account. |
| IncorrectFileSystemLifeCycleStateException | Returned if the file system's lifecycle state is not "available". |
| InsufficientThroughputCapacityException | Returned if there's not enough capacity to provision additional throughput. This value might be returned when you try to create a file system in provisioned throughput mode, when you attempt to increase the provisioned throughput of an existing file system, or when you attempt to change an existing file system from Bursting Throughput to Provisioned Throughput mode. Try again later. |
| InternalServerErrorException | Returned if an error occurred on the server side. |
| ReplicationNotFoundException | Returned if the specified file system does not have a replication configuration. |
| ThroughputLimitExceededException | Returned if the throughput mode or amount of provisioned throughput can't be changed because the throughput limit of 1024 MiB/s has been reached. |
| UnsupportedAvailabilityZoneException | Returned if the requested Amazon EFS functionality is not available in the specified Availability Zone. |
| ValidationException | Returned if the Backup service is not available in the Amazon Web Services Region in which the request was made. |
.NET Framework:
Supported in: 4.7.2 and newer