aws-s3-cp

Copy a local file to an S3 bucket

$ aws s3 cp [file.txt] s3://[bucket-name]/

$ aws s3 cp s3://[bucket-name]/[file.txt] [./local-file.txt]

$ aws s3 cp s3://[source-bucket]/[file.txt] s3://[dest-bucket]/[file.txt]

$ aws s3 cp [./local-dir] s3://[bucket-name]/[prefix/] --recursive

$ aws s3 cp [file.txt] s3://[bucket-name]/ --storage-class [STANDARD_IA]

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

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

aws s3 cp source destination [options]

aws s3 cp copies files between the local filesystem and Amazon S3, or between S3 locations. The source and destination can be a LocalPath (local file/directory) or an S3Uri (s3://bucket-name/key).
The command supports single file transfers, recursive directory copies, and streaming data to/from S3. It handles multipart uploads automatically for large files and can preserve or modify object metadata during copies.

--recursive

Copy all files and objects under the specified directory or S3 prefix

Display operations that would be performed without executing them

Suppress all output during the copy operation

Include files matching the pattern (used with --exclude)

Exclude files matching the pattern from the copy operation

Set access control list: private, public-read, public-read-write, authenticated-read, bucket-owner-full-control

Specify storage class: STANDARD, REDUCEDREDUNDANCY, STANDARDIA, ONEZONEIA, INTELLIGENTTIERING, GLACIER, DEEPARCHIVE, GLACIERIR

Enable server-side encryption: AES256 or aws:kms

KMS key ID for server-side encryption with AWS KMS

Custom metadata to store with the S3 object (JSON format)

Override the MIME type of the uploaded object

Set the Expires header (e.g., 2024-12-31T23:59:59Z)

Prevent overwriting existing files at the destination

Expected stream size in bytes (required for streams over 50GB)

Follow symbolic links when copying (default: follow)

When copying directories recursively, use trailing slashes consistently to control prefix behavior. Pattern matching with --include and --exclude is order-dependent. Copying to/from Glacier storage class requires special flags (--force-glacier-transfer). Streaming operations from stdin require --expected-size for files larger than 50GB.

aws-s3(1), aws-s3-sync(1), aws-s3-mv(1), aws-s3api(1)