TerminateInstances

Amazon Elastic Compute Cloud: 2007-08-29

previous page next page

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

InstanceId.n

One or more instance IDs returned.

Type: String

Yes

Response Elements

The following table describes the default response tags included in TerminateInstances responses.

Name Description

instancesSet

A complex type describing the current and new state of each instance specified.

Type: ec2:TerminateInstancesResponseInfoType[]

Sample Request 

https://ec2.amazonaws.com/
?Action=TerminateInstances
&InstanceId.1=i-2ea64347
&InstanceId.2=i-21a64348
&...auth parameters...

Sample Response 

<TerminateInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2007-08-29">
  <instancesSet>
    <item>
      <instanceId>i-28a64341</instanceId>
      <shutdownState>
        <code>32</code>
        <name>shutting-down</name>
      </shutdownState>
      <previousState>
        <code>16</code>
        <name>running</name>
      </previousState>
    </item>
    <item>
      <instanceId>i-21a64348</instanceId>
      <shutdownState>
        <code>32</code>
        <name>shutting-down</name>
      </shutdownState>
      <previousState>
        <code>16</code>
        <name>running</name>
      </previousState>
    </item>
  </instancesSet>
</TerminateInstancesResponse>

Related Operations

previous page start next page