Amazon EMR
Developer Guide

AMI Version Numbers (Versions 2.x, 3.x)

This documentation is for AMI versions 2.x and 3.x of Amazon EMR. For information about Amazon EMR releases 4.0.0 and above, see the Amazon EMR Release Guide. For information about managing the Amazon EMR service in 4.x releases, see the Amazon EMR Management Guide.

AMI version numbers are composed of three parts major-version.minor-version.patch. There are several ways to specify which version of the AMI to use to launch your cluster, depending on the tool you use to launch the cluster: the SDK, API, or AWS CLI.

  • Fully specified—If you specify the AMI version using all three parts (for example --ami-version 2.0.1) your cluster will be launched on exactly that version. This is useful if you are running an application that depends on a specific AMI version. All tools support this option.

  • Major-minor version specified—If you specify just the major and minor version for the AMI (for example --ami-version 2.0), your cluster will be launched on the AMI that matches those specifications and has the latest patches. If the latest patch for the 2.0 AMI series is .4, the preceding example would launch a cluster using AMI 2.0.4. This option ensures that you receive the benefits of the latest patches for the AMI series specified. All tools support this option.