Skip to main content

Multipart Upload

Large objects should be uploaded to your bucket via multipart upload.

Using AWS CLI

Assuming you have AWS CLI set up already:
user@localhost ~ % aws s3 cp ~/Projects/s3-test/testdata/10Gfile s3://target-bucket/10Gfile --profile mytelnyxprofile --endpoint-url https://us-west-1.telnyxcloudstorage.com
where
  • ~/Projects/s3-test/testdata/10Gfile is the path to the raw bytes stored locally
  • s3://target-bucket/10Gfile is the target bucket name and the object key (aka object name)
Depending on your environment, you may achieve throughput between 20 MiB/s (locally on a home network) to upward of 100+ MiB/s (on a lab or production network in a data center.)

Using AWS API/SDK

The general procedure to use the API/SDK is as follows:
1

CreateMultipartUpload

Initiate the upload session with CreateMultipartUpload.
2

UploadPart

Stream each chunk with UploadPart.
3

CompleteMultipartUpload

Finalize the transfer by calling CompleteMultipartUpload.