EMR / Client / list_instances

list_instances#

EMR.Client.list_instances(**kwargs)#

Provides information for all active Amazon EC2 instances and Amazon EC2 instances terminated in the last 30 days, up to a maximum of 2,000. Amazon EC2 instances in any of the following states are considered active: AWAITING_FULFILLMENT, PROVISIONING, BOOTSTRAPPING, RUNNING.

See also: AWS API Documentation

Request Syntax

response = client.list_instances(
    ClusterId='string',
    InstanceGroupId='string',
    InstanceGroupTypes=[
        'MASTER'|'CORE'|'TASK',
    ],
    InstanceFleetId='string',
    InstanceFleetType='MASTER'|'CORE'|'TASK',
    InstanceStates=[
        'AWAITING_FULFILLMENT'|'PROVISIONING'|'BOOTSTRAPPING'|'RUNNING'|'TERMINATED',
    ],
    Marker='string'
)
Parameters:
  • ClusterId (string) –

    [REQUIRED]

    The identifier of the cluster for which to list the instances.

  • InstanceGroupId (string) – The identifier of the instance group for which to list the instances.

  • InstanceGroupTypes (list) –

    The type of instance group for which to list the instances.

    • (string) –

  • InstanceFleetId (string) – The unique identifier of the instance fleet.

  • InstanceFleetType (string) – The node type of the instance fleet. For example MASTER, CORE, or TASK.

  • InstanceStates (list) –

    A list of instance states that will filter the instances returned with this request.

    • (string) –

  • Marker (string) – The pagination token that indicates the next set of results to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'Instances': [
        {
            'Id': 'string',
            'Ec2InstanceId': 'string',
            'PublicDnsName': 'string',
            'PublicIpAddress': 'string',
            'PrivateDnsName': 'string',
            'PrivateIpAddress': 'string',
            'Status': {
                'State': 'AWAITING_FULFILLMENT'|'PROVISIONING'|'BOOTSTRAPPING'|'RUNNING'|'TERMINATED',
                'StateChangeReason': {
                    'Code': 'INTERNAL_ERROR'|'VALIDATION_ERROR'|'INSTANCE_FAILURE'|'BOOTSTRAP_FAILURE'|'CLUSTER_TERMINATED',
                    'Message': 'string'
                },
                'Timeline': {
                    'CreationDateTime': datetime(2015, 1, 1),
                    'ReadyDateTime': datetime(2015, 1, 1),
                    'EndDateTime': datetime(2015, 1, 1)
                }
            },
            'InstanceGroupId': 'string',
            'InstanceFleetId': 'string',
            'Market': 'ON_DEMAND'|'SPOT',
            'InstanceType': 'string',
            'EbsVolumes': [
                {
                    'Device': 'string',
                    'VolumeId': 'string'
                },
            ]
        },
    ],
    'Marker': 'string'
}

Response Structure

  • (dict) –

    This output contains the list of instances.

    • Instances (list) –

      The list of instances for the cluster and given filters.

      • (dict) –

        Represents an Amazon EC2 instance provisioned as part of cluster.

        • Id (string) –

          The unique identifier for the instance in Amazon EMR.

        • Ec2InstanceId (string) –

          The unique identifier of the instance in Amazon EC2.

        • PublicDnsName (string) –

          The public DNS name of the instance.

        • PublicIpAddress (string) –

          The public IP address of the instance.

        • PrivateDnsName (string) –

          The private DNS name of the instance.

        • PrivateIpAddress (string) –

          The private IP address of the instance.

        • Status (dict) –

          The current status of the instance.

          • State (string) –

            The current state of the instance.

          • StateChangeReason (dict) –

            The details of the status change reason for the instance.

            • Code (string) –

              The programmable code for the state change reason.

            • Message (string) –

              The status change reason description.

          • Timeline (dict) –

            The timeline of the instance status over time.

            • CreationDateTime (datetime) –

              The creation date and time of the instance.

            • ReadyDateTime (datetime) –

              The date and time when the instance was ready to perform tasks.

            • EndDateTime (datetime) –

              The date and time when the instance was terminated.

        • InstanceGroupId (string) –

          The identifier of the instance group to which this instance belongs.

        • InstanceFleetId (string) –

          The unique identifier of the instance fleet to which an Amazon EC2 instance belongs.

        • Market (string) –

          The instance purchasing option. Valid values are ON_DEMAND or SPOT.

        • InstanceType (string) –

          The Amazon EC2 instance type, for example m3.xlarge.

        • EbsVolumes (list) –

          The list of Amazon EBS volumes that are attached to this instance.

          • (dict) –

            EBS block device that’s attached to an Amazon EC2 instance.

            • Device (string) –

              The device name that is exposed to the instance, such as /dev/sdh.

            • VolumeId (string) –

              The volume identifier of the EBS volume.

    • Marker (string) –

      The pagination token that indicates the next set of results to retrieve.

Exceptions

  • EMR.Client.exceptions.InternalServerException

  • EMR.Client.exceptions.InvalidRequestException