RunningInstancesItemType

The RunningInstancesItemType data type.

Operations that use this data type include:

The following table describes the elements contained in RunningInstancesItemType.

NameDescription

instanceId

Unique ID of the instance launched.

Type: xsd:string

imageId

Image ID of the AMI used to launch the instance.

Type: xsd:string

instanceState

The current state of the instance.

  • pending: the instance is in the process of launching

  • running: the instance launched (although it the boot process might not be complete)

  • shutting-down: the instance is shutting down

  • terminated: the instance terminated

Type: ec2:InstanceStateType

privateDnsName

The private DNS name assigned to the instance. This DNS name can only be used inside the Amazon EC2 network. This element remains empty until the instance enters a running state. For more information, see Instance Addressing and Network Security.

Type: xsd:string

dnsName

The public DNS name assigned to the instance. This DNS name is contactable from outside the Amazon EC2 network. This element remains empty until the instance enters a running state. For more information, see Instance Addressing and Network Security.

Type: xsd:string

reason

Optional. Reason for the most recent state transition. This might be an empty string.

Type: xsd:string

keyName

Optional. If this instance was launched with an associated key pair, this displays the key pair name.

Type: xsd:string

amiLaunchIndex

Optional. The AMI launch index, which can be used to find this instance within the launch group. For more information, see Instance Metadata.

Type: xsd:string

productCodes

Optional. Product codes attached to this instance.

Type: ec2:ProductCodeItemType[]

instanceType

The instance type. For more information on instance types, see Selecting Instance Types

Type: xsd:string

launchTime

The time the instance launched.

Type: xs:dateTime