RunningInstancesItemType

The RunningInstancesItemType data type.

Operations that use this data type include:

The following table describes and shows the elements contained in RunningInstancesItemType.

Element NameDescriptionType
instanceId Unique ID of the instance launched. xsd:string
imageId Image ID of the AMI used to launch the instance. xsd:string
instanceState The current state of the instance.
  • pending: the instance is in the process of being launched

  • running: the instance has been launched (although it may not yet have completed the boot process)

  • shutting-down: the instance has begun the shutdown process

  • terminated: the instance has been terminated

ec2:InstanceStateType
privateDnsName The private DNS name assigned to the instance. This DNS name is only contactable from inside the Amazon EC2 network. This element remains empty until the instance enters a running state. See Chapter 5, Using and Securing the Network for more info. 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. See Chapter 5, Using and Securing the Network for more info. xsd:string
reason An optional reason for the most recent state transition. This may be an empty string. xsd:string
keyName An optional key name. If this instance was launched with an associated key pair, this is the name of that key pair. xsd:string
amiLaunchIndex An optional AMI launch index which can be used to determine which instance this is in the launch group. See using instance data for more info. xsd:string
productCodesProduct codes attached to this instance.ec2:ProductCodeItemType[]