Prev		Next

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.

Element Name	Definition	Required?	Type
`InstanceId.n`	One or more instance IDs returned from previous calls to `RunInstances`.	Yes	`string`

Response Tags

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

Element Name	Definition	Type
`instancesSet`	A complex type containing describing the current and new state of each instance specified.	`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-01-19">
  <instancesSet>
    <item>
      <instanceId>i-28a64341</instanceId>
      <shutdownState>
        <code>32</code>
        <name>shutting-down</name>
      </shutdownState>
      <previousState>
        <code>0</code>
        <name>pending</name>
      </previousState>
    </item>
    <item>
      <instanceId>i-21a64348</instanceId>
      <shutdownState>
        <code>32</code>
        <name>shutting-down</name>
      </shutdownState>
      <previousState>
        <code>0</code>
        <name>pending</name>
      </previousState>
    </item>
  </instancesSet>
</TerminateInstancesResponse>

Related Operations

DescribeInstances