Menu
Amazon EMR
Developer Guide

View the AMI Version of a Running Cluster

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.

If you need to find out which AMI version a cluster is running, you can retrieve this information using the console, the CLI, or the API.

To view the current AMI version using the console

  1. Sign in to the AWS Management Console and open the Amazon EMR console at https://console.aws.amazon.com/elasticmapreduce/.

  2. Select a cluster link on the Cluster List page. The AMI Version and other details about the cluster are displayed on the Cluster Details page.

To view the current AMI version using the AWS CLI

Type the describe-cluster subcommand with the cluster-id parameter to retrieve information about a cluster including the AMI version. The cluster identifier is required to use the describe-cluster subcommand. You can retrieve the cluster ID using the console or the list-clusters subcommand.

  • Type the following command to view cluster information.

    Copy
    aws emr describe-cluster --cluster-id j-3QKHXXXXXXARD

    The output shows the AMI version for the cluster:

    Copy
    { "Cluster": { "Status": { "Timeline": { "EndDateTime": 1412976409.738, "CreationDateTime": 1412976134.334 }, "State": "TERMINATED", "StateChangeReason": { "Message": "Terminated by user request", "Code": "USER_REQUEST" } }, "Ec2InstanceAttributes": { "Ec2AvailabilityZone": "us-west-2c" }, "Name": "Static AMI Version", "Tags": [], "TerminationProtected": false, "RunningAmiVersion": "2.4.8", "NormalizedInstanceHours": 0, "InstanceGroups": [ { ... }

    For more information on using Amazon EMR commands in the AWS CLI, see http://docs.aws.amazon.com/cli/latest/reference/emr.

To view the current AMI version using the API

  • Call DescribeJobFlows to check which AMI version a cluster is using. The version will be returned as part of the response data, as shown in the following example. For the complete response syntax, go to DescribeJobFlows in the Amazon EMR API Reference.

    Copy
    <DescribeJobFlowsResponse xmlns=&quot;http://elasticmapreduce.&api-domain;/doc/2009-03-31&quot;> <DescribeJobFlowsResult> <JobFlows> <member> ... <AmiVersion> 2.1.3 </AmiVersion> ... </member> </JobFlows> </DescribeJobFlowsResult> <ResponseMetadata> <RequestId> 9cea3229-ed85-11dd-9877-6fad448a8419 </RequestId> </ResponseMetadata> </DescribeJobFlowsResponse>