Links and directories copied by Amazon DataSync - Amazon DataSync
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Links and directories copied by Amazon DataSync

Amazon DataSync handles copied hard links, symbolic links, and directories differently depending on the storage locations involved in your transfer.

Hard links

When copying between an NFS server, FSx for Lustre, FSx for OpenZFS, FSx for ONTAP (using NFS), and Amazon EFS, hard links are preserved.

When copying to Amazon S3, each hard link is transferred only once. Separate Amazon S3 objects are created for each copy. If a hard link is unchanged in Amazon S3, it's correctly restored upon transfer to an NFS server, FSx for Lustre, FSx for OpenZFS, FSx for ONTAP (using NFS), or Amazon EFS.

When copying between an SMB file share, FSx for Windows File Server, and FSx for ONTAP (using SMB), hard links aren't supported. If DataSync encounters hard links in these situations, the task completes with an error. To learn more, check your CloudWatch logs.

When copying to HDFS, hard links aren't supported. When copying to HDFS, hard links on the source are skipped and logged to CloudWatch.

Symbolic links

When copying between an NFS server, FSx for Lustre, FSx for OpenZFS, FSx for ONTAP (using NFS), and Amazon EFS, symbolic links are preserved.

When copying to Amazon S3, the link target path is stored in the Amazon S3 object. The link is correctly restored upon transfer to an NFS server, FSx for Lustre, FSx for OpenZFS, FSx for ONTAP, or Amazon EFS.

When copying between an SMB file share, FSx for Windows File Server, and FSx for ONTAP (using NFS), symbolic links aren't supported. If DataSync encounters symbolic links in these situations, the task completes with an error. To learn more, check your CloudWatch logs.

When copying to HDFS, symbolic links aren't supported. When copying to HDFS, symbolic links are skipped and logged to CloudWatch.

Directories

When copying to or from Amazon S3 buckets, directories are represented as empty objects ending with /.

For information on logging with DataSync, see Monitoring Amazon DataSync activity with Amazon CloudWatch.