Sample Request
<DescribeInstances xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<instancesSet>
<item>
<instanceId>i-28a64341</instanceId>
</item>
</instancesSet>
</DescribeInstances>
Sample Response
<DescribeInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<reservationSet>
<item>
<reservationId>r-44a5402d</reservationId>
<ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId>
<groupSet>
<item>
<groupId>default</groupId>
</item>
</groupSet>
<instancesSet>
<item>
<instanceId>i-28a64341</instanceId>
<imageId>ami-6ea54007</imageId>
<instanceState>
<code>0</code>
<name>running</name>
</instanceState>
<dnsName>domU-12-31-33-00-00-5A.dc2.compute.amazonaws.com</dnsName>
<keyName>example-key-name</keyName>
</item>
</instancesSet>
</item>
</reservationSet>
</DescribeInstancesResponse>
Related Operations
RunInstances
TerminateInstances
TerminateInstances
The TerminateInstances operation shuts down one or more instances. This operation is idempotent
and terminating an instance that is in the process of shutting down (or already terminated) will succeed.
Terminated instances remain visible for a short period of time (approximately one hour) after
termination, after which their instance ID is invalidated.
Request Parameters
The following table describes the request parameters for TerminateInstances. Parameter names are
case sensitive.
Amazon EC2
Developer Guide
65
Element Name Definition Re-
quired?
Type
instancesSet One or more instance IDs returned from
previous calls to RunInstances.
Yes xsd:string[]
Response Tags
The following table describes the default response tags included in TerminateInstances responses.
Element Name Definition
instancesSet A complex type containing describing the current and new state of
each instance specified.
Sample Request
<TerminateInstances xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<instancesSet>
<item>
<instanceId>i-28a64341</instanceId>
</item>
</instancesSet>
</TerminateInstances>
Sample Response
<TerminateInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<instancesSet>
<item>
<instanceId>i-28a64341</instanceId>
<shutdownState>shutting-down</shutdownState>
<previousState>running</previousState>
</item></instancesSet>
</TerminateInstancesResponse>
Related Operations
DescribeInstances
CreateSecurityGroup
The CreateSecurityGroup operation creates a new security group.
Every instance is launched in a security group. If none is specified as part of the launch request then
instances are launched in the default security group. Instances within the same security group have
unrestricted network access to one another. Instances will reject network access attempts from other
instances in a different security group. As the owner of instances you may grant or revoke specific
permissions using the AuthorizeSecurityGroupIngress and RevokeSecurityGroupIngress operations.
Request Parameters
Amazon EC2
Developer Guide
66
Previous Page Next Page