Skip to content

List Instances

emr_list_instances R Documentation

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

Description

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.

Usage

emr_list_instances(ClusterId, InstanceGroupId, InstanceGroupTypes,
  InstanceFleetId, InstanceFleetType, InstanceStates, Marker)

Arguments

ClusterId

[required] The identifier of the cluster for which to list the instances.

InstanceGroupId

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

InstanceGroupTypes

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

InstanceFleetId

The unique identifier of the instance fleet.

InstanceFleetType

The node type of the instance fleet. For example MASTER, CORE, or TASK.

InstanceStates

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

Marker

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

Value

A list with the following syntax: 

list(
  Instances = list(
    list(
      Id = "string",
      Ec2InstanceId = "string",
      PublicDnsName = "string",
      PublicIpAddress = "string",
      PrivateDnsName = "string",
      PrivateIpAddress = "string",
      Status = list(
        State = "AWAITING_FULFILLMENT"|"PROVISIONING"|"BOOTSTRAPPING"|"RUNNING"|"TERMINATED",
        StateChangeReason = list(
          Code = "INTERNAL_ERROR"|"VALIDATION_ERROR"|"INSTANCE_FAILURE"|"BOOTSTRAP_FAILURE"|"CLUSTER_TERMINATED",
          Message = "string"
        ),
        Timeline = list(
          CreationDateTime = as.POSIXct(
            "2015-01-01"
          ),
          ReadyDateTime = as.POSIXct(
            "2015-01-01"
          ),
          EndDateTime = as.POSIXct(
            "2015-01-01"
          )
        )
      ),
      InstanceGroupId = "string",
      InstanceFleetId = "string",
      Market = "ON_DEMAND"|"SPOT",
      InstanceType = "string",
      EbsVolumes = list(
        list(
          Device = "string",
          VolumeId = "string"
        )
      )
    )
  ),
  Marker = "string"
)

Request syntax

svc$list_instances(
  ClusterId = "string",
  InstanceGroupId = "string",
  InstanceGroupTypes = list(
    "MASTER"|"CORE"|"TASK"
  ),
  InstanceFleetId = "string",
  InstanceFleetType = "MASTER"|"CORE"|"TASK",
  InstanceStates = list(
    "AWAITING_FULFILLMENT"|"PROVISIONING"|"BOOTSTRAPPING"|"RUNNING"|"TERMINATED"
  ),
  Marker = "string"
)