AWS DataSync
User Guide

Creating a Location for Amazon EFS

A location for Amazon EFS is an endpoint for an Amazon EFS file system. If you don't have an Amazon EFS file system in the current AWS Region, create one. For information about how to create an Amazon EFS file system, see Getting Started with Amazon Elastic File System in the Amazon Elastic File System User Guide.

Note

DataSync currently doesn't support transferring files to Amazon EFS volumes that are in dedicated tenancy VPCs. For information about dedicated tenancy VPCs, see Creating a VPC with an Instance Tenancy of Dedicated in the Amazon EC2 User Guide for Linux Instances.

To create an EFS location

  1. Open the AWS DataSync console at https://console.aws.amazon.com/datasync/.

  2. In the navigation pane, choose Locations. The locations that you previously created appear in the list of locations.

  3. On the Create location page, choose EFS for Location type.

  4. For File system, choose the EFS file system that you want to use as an endpoint. You configure this location as a source or destination later.

  5. For Mount path, enter the mount path for your EFS file system. The path can include a subdirectory. If so, this is a subdirectory in the EFS file system that is used to read data from the EFS location or write data to the EFS destination. By default, DataSync uses the root directory.

  6. For Subnet and Security Group, the DataSync console automatically chooses a subnet that includes a mount target for your Amazon EFS file system and this subnet’s default security group. We recommend using these default settings.

    Note

    DataSync uses the security group specified in this step to connect to your Amazon EFS file system. If the security group is configured to disallow connections from within itself, you have two options. One is to change this configuration to allow the security group to communicate within itself. The other is to choose a different subnet and security group, such that the following is true:

    • The selected subnet contains a mount target for your EFS file system.

    • The selected security group can communicate with that mount target's security group.

    For detailed information about security groups and mount targets, see Security Groups for Amazon EC2 Instances and Mount Targets in the Amazon Elastic File System User Guide.

  7. (Optional) Provide values for the Key and Value fields to tag the EFS file system. A tag is a key-value pair that helps you manage, filter, and search for your locations. We recommend using tags for naming your resources.

  8. When you are done, choose Create location. The location that you just created appears in the list of locations.

Considerations When Creating a Location for Amazon EFS

Be sure to consider the following when creating a location for Amazon EFS:

  • When you create an Amazon EFS file system in Bursting Throughput mode, you get an allocation of 2.1 TB worth of burst credits. All Amazon EFS file systems are able to burst up to 100 MB/s of throughput when using Bursting Throughput mode. File systems that are larger than 1 TiB can burst to twice their baseline throughput. Note that DataSync consumes file system burst credits. This can have an impact on the performance of your applications. When using DataSync with a file system that has an active workload, consider using EFS Provisioned Throughput.

  • Amazon EFS file systems that are in General Purpose performance mode have a limit of 7,000 file system operations per second. This limit can impact the maximum throughput DataSync can achieve when copying files.

    For more information, see Amazon EFS Performance in the Amazon Elastic File System User Guide.