RunningInstancesItemType

The RunningInstancesItemType data type.

The following table describes the elements contained in RunningInstancesItemType.

NameDescription

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

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

imageId

Image ID of the AMI used to launch the instance.

Type: xsd:string

instanceId

Unique ID of the instance launched.

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: InstanceStateType

instanceType

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

Type: xsd:string

keyName

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

Type: xsd:string

kernelId

Optional. Kernel associated with this instance.

Type: xsd:string

launchTime

The time the instance launched.

Type: xs:dateTime

placement

The location where the instance launched.

Type: PlacementResponseType

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

productCodes

Optional. Product codes attached to this instance.

Type: ProductCodeItemType[]

ramdiskId

Optional. RAM disk associated with this instance.

Type: xsd:string

reason

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

Type: xsd:string