Page updated Nov 12, 2023

Use transfer acceleration

When you use Transfer Acceleration, additional data transfer charges might apply. For more information about pricing, see Amazon S3 pricing.

You can enable Transfer Acceleration for fast and secure transfer of files over long distances between your end user device and the S3 bucket. You can override the storage resource for this configuration and then leverage the useAccelerateEndpoint parameter to use the accelerated S3 endpoint.

Override storage resource

Start by overriding your storage resources to enable Transfer Acceleration on your S3 bucket.

$ amplify override storage ✅ Successfully generated "override.ts" folder at <project>/amplify/backend/storage/accelerated-bucket ✔ Do you want to edit override.ts file now? (Y/n) · yes Edit the file in your editor: <project>/amplify/backend/storage/accelerated-bucket/override.ts
1$ amplify override storage
2✅ Successfully generated "override.ts" folder at <project>/amplify/backend/storage/accelerated-bucket
3✔ Do you want to edit override.ts file now? (Y/n) · yes
4Edit the file in your editor: <project>/amplify/backend/storage/accelerated-bucket/override.ts

In the generated override.ts file use the following CDK snippet to enable transfer acceleration.

// amplify/backend/storage/accelerated-bucket/override.ts import { AmplifyS3ResourceTemplate } from '@aws-amplify/cli-extensibility-helper'; export function override(resources: AmplifyS3ResourceTemplate) { resources.s3Bucket.accelerateConfiguration = { accelerationStatus: 'Enabled' } }
1// amplify/backend/storage/accelerated-bucket/override.ts
2import { AmplifyS3ResourceTemplate } from '@aws-amplify/cli-extensibility-helper';
4export function override(resources: AmplifyS3ResourceTemplate) {
5 resources.s3Bucket.accelerateConfiguration = {
6 accelerationStatus: 'Enabled'
7 }

Next, deploy this storage resource:

amplify push
1amplify push

Upload files using the accelerated S3 endpoint

We switch to the accelerated S3 endpoint by using the useAccelerateEndpoint parameter set to true. For example the getUrl method

const getUrlResult = await getUrl({ key: filename, options: { useAccelerateEndpoint: true; // Whether to use accelerate endpoint. }, });
1const getUrlResult = await getUrl({
2 key: filename,
3 options: {
4 useAccelerateEndpoint: true; // Whether to use accelerate endpoint.
5 },

The following Storage APIs support accelerated endpoint

  • getUrl
  • getProperties
  • list
  • remove
  • downloadData
  • uploadData