CreateReplicationConfiguration
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.
Note
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 AWS 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.
Request Syntax
POST /2015-02-01/file-systems/SourceFileSystemId
/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string
",
"FileSystemId": "string
",
"KmsKeyId": "string
",
"Region": "string
",
"RoleArn": "string
"
}
]
}
URI Request Parameters
The request uses the following URI parameters.
- SourceFileSystemId
-
Specifies the Amazon EFS file system that you want to replicate. This file system cannot already be a source or destination file system in another replication configuration.
Length Constraints: Maximum length of 128.
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
Required: Yes
Request Body
The request accepts the following data in JSON format.
- Destinations
-
An array of destination configuration objects. Only one destination configuration object is supported.
Type: Array of DestinationToCreate objects
Required: Yes
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- CreationTime
-
Describes when the replication configuration was created.
Type: Timestamp
- Destinations
-
An array of destination objects. Only one destination object is supported.
Type: Array of Destination objects
- OriginalSourceFileSystemArn
-
The Amazon Resource Name (ARN) of the original source EFS file system in the replication configuration.
Type: String
- SourceFileSystemArn
-
The Amazon Resource Name (ARN) of the current source file system in the replication configuration.
Type: String
- SourceFileSystemId
-
The ID of the source Amazon EFS file system that is being replicated.
Type: String
Length Constraints: Maximum length of 128.
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
- SourceFileSystemOwnerId
-
ID of the AWS account in which the source file system resides.
Type: String
Length Constraints: Maximum length of 14.
Pattern:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- SourceFileSystemRegion
-
The AWS Region in which the source EFS file system is located.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Pattern:
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
Errors
- BadRequest
-
Returned if the request is malformed or contains an error such as an invalid parameter value or a missing required parameter.
HTTP Status Code: 400
- ConflictException
-
Returned if the source file system in a replication is encrypted but the destination file system is unencrypted.
HTTP Status Code: 409
- FileSystemLimitExceeded
-
Returned if the AWS account has already created the maximum number of file systems allowed per account.
HTTP Status Code: 403
- FileSystemNotFound
-
Returned if the specified
FileSystemId
value doesn't exist in the requester's AWS account.HTTP Status Code: 404
- IncorrectFileSystemLifeCycleState
-
Returned if the file system's lifecycle state is not "available".
HTTP Status Code: 409
- InsufficientThroughputCapacity
-
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.
HTTP Status Code: 503
- InternalServerError
-
Returned if an error occurred on the server side.
HTTP Status Code: 500
- ReplicationNotFound
-
Returned if the specified file system does not have a replication configuration.
HTTP Status Code: 404
- ThroughputLimitExceeded
-
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.
HTTP Status Code: 400
- UnsupportedAvailabilityZone
-
Returned if the requested Amazon EFS functionality is not available in the specified Availability Zone.
HTTP Status Code: 400
- ValidationException
-
Returned if the AWS Backup service is not available in the AWS Region in which the request was made.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: