Amazon Elastic Compute Cloud
API Reference (API Version 2011-12-15)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

RunningInstancesItemType

The RunningInstancesItemType data type.

Ancestors

  • RunningInstancesSetType

Relevant Operations

  • DescribeInstances

  • RunInstances

Contents

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.

Type: 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.

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.

Type: xsd:string

reason

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

Type: xsd:string

keyName

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

Type: xsd:string

amiLaunchIndex

The AMI launch index, which can be used to find this instance within the launch group.

Type: xsd:string

productCodes

Product codes attached to this instance. Each product code's information is wrapped in an item element.

Type: ProductCodesSetItemType

instanceType

The instance type (e.g., m1.small).

Type: xsd:string

launchTime

The time the instance launched.

Type: xsd:dateTime

placement

The location where the instance launched.

Type: PlacementResponseType

kernelId

Kernel associated with this instance.

Type: xsd:string

ramdiskId

RAM disk associated with this instance.

Type: xsd:string

platform

Platform of the instance (e.g., Windows).

Type: xsd:string

monitoring

Whether monitoring is enabled for the instance.

Type: InstanceMonitoringStateType

subnetId

The Amazon VPC subnet ID in which the instance is running.

Type: xsd:string

vpcId

The Amazon VPC in which the instance is running.

Type: xsd:string

privateIpAddress

The private IP address assigned to the instance.

Type: xsd:string

ipAddress

The IP address of the instance.

Type: xsd:string

sourceDestCheck

This attribute exists to enable a Network Address Translation (NAT) instance in a VPC to perform NAT. The attribute controls whether source/destination checking is enabled on the instance. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the instance to perform NAT. For more information, go to NAT Instances in the Amazon Virtual Private Cloud User Guide.

Type: xsd:boolean

groupSet

A list of VPC security groups the instance is in. Each group's information is wrapped in an item element.

Type: GroupItemType

stateReason

The reason for the most recent state transition. See StateReasonType for a listing of supported state change codes.

Type: StateReasonType

architecture

The architecture of the image.

Type: xsd:string

Valid Values: i386 | x86_64

rootDeviceType

The root device type used by the AMI. The AMI can use an Amazon EBS or instance store root device.

Type: xsd:string

Valid Values: ebs | instance-store

rootDeviceName

The root device name (e.g., /dev/sda1).

Type: xsd:string

blockDeviceMapping

A list of block device mappings for the instance. Each mapping's information is wrapped in an item element.

Type: InstanceBlockDeviceMappingResponseItemType

instanceLifecycle

Whether this is a Spot Instance.

Type: xsd:string

Valid Values: spot | blank (no value)

spotInstanceRequestId

The ID of the Spot Instance request.

Type: xsd:string

virtualizationType

The instance's virtualization type.

Type: xsd:string

Valid Values: paravirtual | hvm

clientToken

Idempotency token you provided when you launched the instance.

Type: xsd:string

tagSet

Tags assigned to the resource. Each tag's information is wrapped in an item element.

Type: ResourceTagSetItemType

hypervisor

The instance's hypervisor type.

Type: xsd:string

Valid Values: ovm | xen

networkInterfaceSet

Type: InstanceNetworkInterfaceSetType