Page updated Jan 16, 2024

Use existing AWS resources

Amplify iOS v1 is now in Maintenance Mode until May 31st, 2024. This means that we will continue to include updates to ensure compatibility with backend services and security. No new features will be introduced in v1.

Please use the latest version (v2) of Amplify Library for Swift to get started.

If you are currently using v1, follow these instructions to upgrade to v2.

Amplify libraries should be used for all new cloud connected applications. If you are currently using the AWS Mobile SDK for iOS, you can access the documentation here.

If you are using the Amplify CLI, an existing Amazon S3 bucket can be used with the Amplify Libraries by running:

1amplify import storage

For more details, see how to Use an existing S3 bucket or DynamoDB table.

If you are not using the Amplify CLI, an existing Amazon S3 bucket can be used by referencing it in your amplifyconfiguration.json file.

When you are not using Amplify CLI, adding existing Amazon S3 bucket to your application may require configuring bucket access permissions. e.g. Enabling read/write access to the cognito user pool that you are using with the Amplify Auth category.

1{
2 "storage": {
3 "plugins": {
4 "awsS3StoragePlugin": {
5 "bucket": "[BUCKET NAME]",
6 "region": "[REGION]"
7 }
8 }
9 }
10}
  • bucket: Name of the bucket to use for storage
  • region: AWS Region where the bucket is provisioned (e.g. us-east-1)

Note that before you can add an AWS resource to your application, the application must have the Amplify libraries installed. If you need to perform this step, see Install Amplify Libraries.