Migrating from AWS CLI version 1 to AWS CLI version 2

This section contains instructions for updating the AWS CLI version 1 to AWS CLI version 2. The AWS CLI version 2 builds on AWS CLI version 1 and includes features and enhancements based on community feedback. The AWS CLI version 2 is the most recent major version of the AWS CLI and supports all of the latest features. Some features introduced in version 2 are not backported to version 1 and you must upgrade to access those features.

To prevent unexpected issues, before you migrate to version 2, learn about the differences between the versions. The AWS CLI version 2 includes new features and changes that might require you to update your scripts or commands for backwards compatibility.

AWS CLI versions 1 and 2 use the same aws command name. If you have both versions installed, your computer uses the first one found in your search path. This could result in your aws command name calling your old AWS CLI version, even when you have the new one installed.

If you previously installed AWS CLI version 1, follow the instructions in Installing AWS CLI version 2 from AWS CLI version 1.

If you have not previously installed AWS CLI version 1, follow the instructions in Getting started with the AWS CLI.