Modify Amplify-generated resources

Amplify Storage uses underlying AWS services and resources such as S3 and DynamoDB. You can customize these underlying resources for your specific use case.

1amplify override storage

Run the command above to override Amplify-generated storage resources including the S3 bucket, DynamoDB tables, and more.

The command creates a new overrides.ts file under amplify/backend/storage/<resource-name>/ which provides you the Amplify-generated resources as CDK constructs.

Customize Amplify-generated S3 resources

Apply all the overrides in the override(...) function. For example to enable versioning on your S3 bucket:

1import { AmplifyS3ResourceTemplate } from '@aws-amplify/cli-extensibility-helper';
2
3export function override(resources: AmplifyS3ResourceTemplate) {
4  resources.s3Bucket.versioningConfiguration = {
5    status: 'Enabled'
6  };
7}

You can override the following S3-related resources that Amplify generates:

For example, you can use amplify override storage to add additional PUT and GET access IAM policy statements to the S3 bucket's default public Auth policy:

1import { AmplifyS3ResourceTemplate } from '@aws-amplify/cli-extensibility-helper';
2
3export function override(resources: AmplifyS3ResourceTemplate) {
4  resources.s3AuthPublicPolicy.policyDocument.Statement = [
5    ...resources.s3AuthPublicPolicy.policyDocument.Statement,
6    {
7      Effect: 'Allow',
8      Action: ['s3:PutObject', 's3:PutObjectAcl', 's3:GetObject'],
9      Resource: '<ARN of the S3 resource>'
10    }
11  ];
12}

Please refer to the IAM documentation for more information on actions, resources, and condition keys for Amazon S3.

Customize Amplify-generated DynamoDB tables

Apply all the overrides in the override(...) function. For example to enable time-to-live specification on your DynamoDB table:

1import { AmplifyDDBResourceTemplate } from '@aws-amplify/cli-extensibility-helper';
2
3export function override(resources: AmplifyDDBResourceTemplate) {
4  resources.dynamoDBTable.timeToLiveSpecification = {
5    attributeName: 'ttl',
6    enabled: true
7  };
8}

You can override the following DynamoDB resources that Amplify generates: