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"
)