Note: You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . emr ]

describe-cluster

Description

Provides cluster-level details including status, hardware and software configuration, VPC settings, bootstrap actions, instance groups and so on. Permissions needed for describe-cluster include elasticmapreduce:ListBootstrapActions, elasticmapreduce:ListInstanceFleets, elasticmapreduce:DescribeCluster, and elasticmapreduce:ListInstanceGroups.

See 'aws help' for descriptions of global parameters.

Synopsis

  describe-cluster
--cluster-id <value>

Options

--cluster-id (string)

A unique string that identifies a cluster. The create-cluster command returns this identifier. You can use the list-clusters command to get cluster IDs.

See 'aws help' for descriptions of global parameters.

Examples

Note

To use the following examples, you must have the AWS CLI installed and configured. See the Getting started guide in the AWS CLI User Guide for more information.

Unless otherwise stated, all examples have unix-like quotation rules. These examples will need to be adapted to your terminal's quoting rules. See Using quotation marks with strings in the AWS CLI User Guide .

  • Command:

    aws emr describe-cluster --cluster-id j-XXXXXXXX
    
  • Output:

    For release-label based uniform instance groups cluster:
    
            {
                "Cluster": {
                    "Status": {
                        "Timeline": {
                            "ReadyDateTime": 1436475075.199,
                            "CreationDateTime": 1436474656.563,
                        },
                        "State": "WAITING",
                        "StateChangeReason": {
                            "Message": "Waiting for steps to run"
                        }
                    },
                    "Ec2InstanceAttributes": {
                        "ServiceAccessSecurityGroup": "sg-xxxxxxxx",
                        "EmrManagedMasterSecurityGroup": "sg-xxxxxxxx",
                        "IamInstanceProfile": "EMR_EC2_DefaultRole",
                        "Ec2KeyName": "myKey",
                        "Ec2AvailabilityZone": "us-east-1c",
                        "EmrManagedSlaveSecurityGroup": "sg-yyyyyyyyy"
                    },
                    "Name": "My Cluster",
                    "ServiceRole": "EMR_DefaultRole",
                    "Tags": [],
                    "TerminationProtected": true,
                    "ReleaseLabel": "emr-4.0.0",
                    "NormalizedInstanceHours": 96,
                    "InstanceGroups": [
                        {
                            "RequestedInstanceCount": 2,
                            "Status": {
                                "Timeline": {
                                    "ReadyDateTime": 1436475074.245,
                                    "CreationDateTime": 1436474656.564,
                                    "EndDateTime": 1436638158.387
                                },
                                "State": "RUNNING",
                                "StateChangeReason": {
                                    "Message": "",
                                }
                            },
                            "Name": "CORE",
                            "InstanceGroupType": "CORE",
                            "Id": "ig-YYYYYYY",
                            "Configurations": [],
                            "InstanceType": "m3.large",
                            "Market": "ON_DEMAND",
                            "RunningInstanceCount": 2
                        },
                        {
                            "RequestedInstanceCount": 1,
                            "Status": {
                                "Timeline": {
                                    "ReadyDateTime": 1436475074.245,
                                    "CreationDateTime": 1436474656.564,
                                    "EndDateTime": 1436638158.387
                                },
                                "State": "RUNNING",
                                "StateChangeReason": {
                                    "Message": "",
                                }
                            },
                            "Name": "MASTER",
                            "InstanceGroupType": "MASTER",
                            "Id": "ig-XXXXXXXXX",
                            "Configurations": [],
                            "InstanceType": "m3.large",
                            "Market": "ON_DEMAND",
                            "RunningInstanceCount": 1
                        }
                    ],
                    "Applications": [
                        {
                            "Name": "Hadoop"
                        }
                    ],
                    "VisibleToAllUsers": true,
                    "BootstrapActions": [],
                    "MasterPublicDnsName": "ec2-54-147-144-78.compute-1.amazonaws.com",
                    "AutoTerminate": false,
                    "Id": "j-XXXXXXXX",
                    "Configurations": [
                        {
                            "Properties": {
                                "fs.s3.consistent.retryPeriodSeconds": "20",
                                "fs.s3.enableServerSideEncryption": "true",
                                "fs.s3.consistent": "false",
                                "fs.s3.consistent.retryCount": "2"
                            },
                            "Classification": "emrfs-site"
                        }
                    ]
                }
            }
    
    
    For release-label based instance fleet cluster:
    {
        "Cluster": {
            "Status": {
                "Timeline": {
                    "ReadyDateTime": 1487897289.705,
                    "CreationDateTime": 1487896933.942
                },
                "State": "WAITING",
                "StateChangeReason": {
                    "Message": "Waiting for steps to run"
                }
            },
            "Ec2InstanceAttributes": {
                "EmrManagedMasterSecurityGroup": "sg-xxxxx",
                "RequestedEc2AvailabilityZones": [],
                "RequestedEc2SubnetIds": [],
                "IamInstanceProfile": "EMR_EC2_DefaultRole",
                "Ec2AvailabilityZone": "us-east-1a",
                "EmrManagedSlaveSecurityGroup": "sg-xxxxx"
            },
            "Name": "My Cluster",
            "ServiceRole": "EMR_DefaultRole",
            "Tags": [],
            "TerminationProtected": false,
            "ReleaseLabel": "emr-5.2.0",
            "NormalizedInstanceHours": 472,
            "InstanceCollectionType": "INSTANCE_FLEET",
            "InstanceFleets": [
                {
                    "Status": {
                        "Timeline": {
                            "ReadyDateTime": 1487897212.74,
                            "CreationDateTime": 1487896933.948
                        },
                        "State": "RUNNING",
                        "StateChangeReason": {
                            "Message": ""
                        }
                    },
                    "ProvisionedSpotCapacity": 1,
                    "Name": "MASTER",
                    "InstanceFleetType": "MASTER",
                    "LaunchSpecifications": {
                        "SpotSpecification": {
                            "TimeoutDurationMinutes": 60,
                            "TimeoutAction": "TERMINATE_CLUSTER"
                        }
                    },
                    "TargetSpotCapacity": 1,
                    "ProvisionedOnDemandCapacity": 0,
                    "InstanceTypeSpecifications": [
                        {
                            "BidPrice": "0.5",
                            "InstanceType": "m3.xlarge",
                            "WeightedCapacity": 1
                        }
                    ],
                    "Id": "if-xxxxxxx",
                    "TargetOnDemandCapacity": 0
                }
            ],
            "Applications": [
                {
                    "Version": "2.7.3",
                    "Name": "Hadoop"
                }
            ],
            "ScaleDownBehavior": "TERMINATE_AT_INSTANCE_HOUR",
            "VisibleToAllUsers": true,
            "BootstrapActions": [],
            "MasterPublicDnsName": "ec2-xxx-xx-xxx-xx.compute-1.amazonaws.com",
            "AutoTerminate": false,
            "Id": "j-xxxxx",
            "Configurations": []
        }
    }
    
    For ami based uniform instance group cluster:
    
        {
            "Cluster": {
                "Status": {
                    "Timeline": {
                        "ReadyDateTime": 1399400564.432,
                        "CreationDateTime": 1399400268.62
                    },
                    "State": "WAITING",
                    "StateChangeReason": {
                        "Message": "Waiting for steps to run"
                    }
                },
                "Ec2InstanceAttributes": {
                    "IamInstanceProfile": "EMR_EC2_DefaultRole",
                    "Ec2AvailabilityZone": "us-east-1c"
                },
                "Name": "My Cluster",
                "Tags": [],
                "TerminationProtected": true,
                "RunningAmiVersion": "2.5.4",
                "InstanceGroups": [
                    {
                        "RequestedInstanceCount": 1,
                        "Status": {
                            "Timeline": {
                                "ReadyDateTime": 1399400558.848,
                                "CreationDateTime": 1399400268.621
                            },
                            "State": "RUNNING",
                            "StateChangeReason": {
                                "Message": ""
                            }
                        },
                        "Name": "Master instance group",
                        "InstanceGroupType": "MASTER",
                        "InstanceType": "m1.small",
                        "Id": "ig-ABCD",
                        "Market": "ON_DEMAND",
                        "RunningInstanceCount": 1
                    },
                    {
                        "RequestedInstanceCount": 2,
                        "Status": {
                            "Timeline": {
                                "ReadyDateTime": 1399400564.439,
                                "CreationDateTime": 1399400268.621
                            },
                            "State": "RUNNING",
                            "StateChangeReason": {
                                "Message": ""
                            }
                        },
                        "Name": "Core instance group",
                        "InstanceGroupType": "CORE",
                        "InstanceType": "m1.small",
                        "Id": "ig-DEF",
                        "Market": "ON_DEMAND",
                        "RunningInstanceCount": 2
                    }
                ],
                "Applications": [
                    {
                        "Version": "1.0.3",
                        "Name": "hadoop"
                    }
                ],
                "BootstrapActions": [],
                "VisibleToAllUsers": false,
                "RequestedAmiVersion": "2.4.2",
                "LogUri": "s3://myLogUri/",
                "AutoTerminate": false,
                "Id": "j-XXXXXXXX"
            }
        }