aws-s3-sync

Sync a local directory to an S3 bucket

$ aws s3 sync [./local-dir] s3://[bucket-name]/

$ aws s3 sync s3://[bucket-name]/ [./local-dir]

$ aws s3 sync s3://[source-bucket] s3://[dest-bucket]

$ aws s3 sync [./local-dir] s3://[bucket-name]/ --delete

$ aws s3 sync [./local-dir] s3://[bucket-name]/ --exclude "*.log"

$ aws s3 sync [./local-dir] s3://[bucket-name]/ --dryrun

$ aws s3 sync [./local-dir] s3://[bucket-name]/ --no-overwrite

aws s3 sync source destination [options]

aws s3 sync synchronizes directories and S3 prefixes by recursively copying new and updated files from the source to the destination. It only transfers files that are new or have changed, making it efficient for incremental backups and deployments.
By default, sync compares file size and last modified time to determine which files need updating. It creates folders in the destination only if they contain files.

--delete

Delete destination files that don't exist in the source

Display operations that would be performed without executing them

Suppress all output except errors

Only transfer files not present at the destination

Use file size alone to determine if sync is needed (ignore timestamps)

Match timestamps exactly when syncing from S3 to local

Include files matching the pattern

Exclude files matching the pattern from the sync

Set access control list: private, public-read, etc.

Specify storage class: STANDARD, STANDARD_IA, GLACIER, etc.

Source bucket region (required for cross-region S3 to S3 sync)

The --delete option removes files from the destination that don't exist in the source; use with caution. Pattern matching with --include and --exclude is order-dependent. When syncing to local, directories are not created unless they contain files. Sync does not preserve symbolic links.

aws-s3(1), aws-s3-cp(1), rsync(1)