Migrate from Amazon CLI version 1 to Amazon CLI version 2 - Amazon Command Line Interface
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Migrate from Amazon CLI version 1 to Amazon CLI version 2

This section contains instructions for updating the Amazon CLI version 1 to Amazon CLI version 2. The Amazon CLI version 2 builds on Amazon CLI version 1 and includes features and enhancements based on community feedback. The Amazon CLI version 2 is the most recent major version of the Amazon 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 Amazon CLI version 2 includes new features and changes that might require you to update your scripts or commands for backwards compatibility.

Amazon 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 Amazon CLI version, even when you have the new one installed.

If you previously installed Amazon CLI version 1, follow the instructions in Amazon CLI version 2 migration instructions.

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

Topics