Upgrade Amazon S3 Connector to Version 5.x

Supported Upgrade Paths

From Version To Version



Changes in This Release

  • Added support for custom domain endpoints to provide Amazon Virtual Private Cloud (VPC) feature utilization.

  • Upgraded the Amazon SDK for Java dependency to version 1.11.969.


Ensure your system meets the following compatibility requirements before you perform the upgrade:

Application/Service Version


4.1.1 and later

AWS SDK for Java


Upgrade Prerequisites

Before you perform the upgrade, create a backup of your files, data, and configuration in case you need to restore to the previous version.

Upgrade Steps

Follow these steps to perform the upgrade to version 5.7.0:

  1. In Anypoint Studio, create a Mule project.

  2. In the Mule Palette view, click Search in Exchange.

  3. In Add Dependencies to Project, enter amazon s3 in the search field.

  4. In Available modules, select Amazon S3 and click Add.

  5. Click Finish.

  6. Verify that the Amazon S3 dependency version is 5.5 in the pom.xml file in the Mule project.

Studio upgrades the connector automatically.

Post-Upgrade Steps

After you install the latest version of the connector, verify that your error handling is updated to work with the minor changes in error codes in this version of the connector.

Verify the Upgrade

After you install the latest version of the connector, follow these steps to verify the upgrade:

  1. In Studio, verify that there are no errors in the Problems or Console views.

  2. Verify that there are no problems in the project pom.xml file.

  3. Test the connection to verify that the operations work.

Revert the Upgrade

If it is necessary to revert to the previous version of Amazon S3, change the mule-amazon-s3 dependency version in the project’s pom.xml file to the previous version.

You must update the project’s pom.xml file in Anypoint Studio.