Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

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. For information about the cluster steps, see <code>list-steps</code>.

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

  • 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"
            }
        }