# ReplicationConfiguration

EFS Replication Configuration.

- Source: [`aws-efs/lib/efs-file-system.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-efs/lib/efs-file-system.ts#L462)
- Type last changed: v2.234.0 · 8 Jan 2026

## Example

```ts
declare const vpc: ec2.Vpc;

// auto generate a regional replication destination file system
new efs.FileSystem(this, 'RegionalReplicationFileSystem', {
  vpc,
  replicationConfiguration: efs.ReplicationConfiguration.regionalFileSystem('us-west-2'),
});

// auto generate a one zone replication destination file system
new efs.FileSystem(this, 'OneZoneReplicationFileSystem', {
  vpc,
  replicationConfiguration: efs.ReplicationConfiguration.oneZoneFileSystem('us-east-1', 'us-east-1a'),
});

const destinationFileSystem = new efs.FileSystem(this, 'DestinationFileSystem', {
  vpc,
  // set as the read-only file system for use as a replication destination
  replicationOverwriteProtection: efs.ReplicationOverwriteProtection.DISABLED,
});
// specify the replication destination file system
new efs.FileSystem(this, 'ReplicationFileSystem', {
  vpc,
  replicationConfiguration: efs.ReplicationConfiguration.existingFileSystem(destinationFileSystem),
});
```

## Initializer

```ts
new ReplicationConfiguration(options: ReplicationConfigurationProps)
```

## Properties

- `availabilityZone`: string — The availability zone name of the destination file system.

  One zone file system is used as the destination file system when this property is set.

- `destinationFileSystem`: [IFileSystem](/cdk/api/v2/docs/aws-cdk-lib.aws_efs.IFileSystem.html) — The existing destination file system for the replication.

- `kmsKey`: [IKey](/cdk/api/v2/docs/aws-cdk-lib.aws_kms.IKey.html) — AWS KMS key used to protect the encrypted file system.

- `region`: string — The AWS Region in which the destination file system is located.

## Methods

- `existingFileSystem(destinationFileSystem: IFileSystemRef): ReplicationConfiguration // chainable` (static) — Specify the existing destination file system for the replication.

  **Parameters**

  - `destinationFileSystem` — The existing destination file system for the replication.

- `oneZoneFileSystem(region: string, availabilityZone: string, kmsKey?: IKey): ReplicationConfiguration // chainable` (static) — Create a new one zone destination file system for the replication.

  **Parameters**

  - `region` — The AWS Region in which the specified availability zone belongs to.
  - `availabilityZone` — The availability zone name of the destination file system.
  - `kmsKey` — AWS KMS key used to protect the encrypted file system.

- `regionalFileSystem(region?: string, kmsKey?: IKey): ReplicationConfiguration // chainable` (static) — Create a new regional destination file system for the replication.

  **Parameters**

  - `region` — The AWS Region in which the destination file system is located.
  - `kmsKey` — AWS KMS key used to protect the encrypted file system.