TerminateInstances
The TerminateInstances
operation shuts down
one or more instances. This operation is idempotent; if you terminate
an instance more than once, each call will succeed.
Terminated instances will remain visible after termination (approximately one hour).
Request Parameters
The following table describes the request parameters for
TerminateInstances
. Parameter names are case
sensitive.
Name | Description | Required |
---|---|---|
|
One or more instance IDs. Type: xsd:string[] |
Yes |
Response Elements
The following table describes the default response tags included
in TerminateInstances
responses.
Name | Description |
---|---|
|
A complex type describing the current and new state of each instance specified. |
Sample Request
<TerminateInstances xmlns="http://ec2.amazonaws.com/doc/2008-08-08"> <instancesSet> <item> <instanceId>i-28a64341</instanceId> </item> </instancesSet> </TerminateInstances>
Sample Response
<TerminateInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2008-08-08"> <instancesSet> <item> <instanceId>i-28a64341</instanceId> <shutdownState> <code>32</code> <name>shutting-down</name> </shutdownState> <previousState> <code>16</code> <name>running</name> </previousState> </item> </instancesSet> </TerminateInstancesResponse>