Skip to content

aws.emr.list_instances

Example SQL Queries

SELECT * FROM
aws.emr.list_instances
WHERE
"cluster_id" = 'VALUE';

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.

Table Definition

Column NameColumn Data Type
cluster_id Required Input Column

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

VARCHAR
instance_fleet_id Input Column

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

VARCHAR
instance_fleet_type Input Column

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

VARCHAR
instance_group_id Input Column

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

VARCHAR
instance_group_types Input Column

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

VARCHAR[]
Show child fields
instance_group_types[]
instance_states Input Column

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

VARCHAR[]
Show child fields
instance_states[]
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
"type" VARCHAR,
"name" VARCHAR,
"account_id" VARCHAR,
"via_profile_name" VARCHAR,
"assumed_role_arn" VARCHAR,
"organization" STRUCT(
"account_name" VARCHAR,
"id" VARCHAR,
"tags" STRUCT(
"key" VARCHAR,
"value" VARCHAR
)[],
"master_account" STRUCT(
"id" VARCHAR,
"email" VARCHAR
),
"parents" STRUCT(
"type" VARCHAR,
"id" VARCHAR,
"name" VARCHAR,
"tags" STRUCT(
"key" VARCHAR,
"value" VARCHAR
)[]
)[]
)
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

ebs_volumes

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

STRUCT(
"device" VARCHAR,
"volume_id" VARCHAR
)[]
Show child fields
ebs_volumes[]
Show child fields
ebs_volumes[].device

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

ebs_volumes[].volume_id

The volume identifier of the EBS volume.

ec2_instance_id

The unique identifier of the instance in Amazon EC2.

VARCHAR
id

The unique identifier for the instance in Amazon EMR.

VARCHAR
instance_type

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

VARCHAR
market

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

VARCHAR
private_dns_name

The private DNS name of the instance.

VARCHAR
private_ip_address

The private IP address of the instance.

VARCHAR
public_dns_name

The public DNS name of the instance.

VARCHAR
public_ip_address

The public IP address of the instance.

VARCHAR
status

The current status of the instance.

STRUCT(
"state" VARCHAR,
"state_change_reason" STRUCT(
"code" VARCHAR,
"message" VARCHAR
),
"timeline" STRUCT(
"creation_date_time" TIMESTAMP_S,
"ready_date_time" TIMESTAMP_S,
"end_date_time" TIMESTAMP_S
)
)
Show child fields
status.state

The current state of the instance.

status.state_change_reason

The details of the status change reason for the instance.

Show child fields
status.state_change_reason.code

The programmable code for the state change reason.

status.state_change_reason.message

The status change reason description.

status.timeline

The timeline of the instance status over time.

Show child fields
status.timeline.creation_date_time

The creation date and time of the instance.

status.timeline.end_date_time

The date and time when the instance was terminated.

status.timeline.ready_date_time

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