TerminateInstances
Description
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
| Name | Description | Required |
|---|---|---|
| Instance ID to terminate. Type: String Default: None | Yes |
Response Elements
| Name | Description |
|---|---|
|
Type: |
Ancestor: None
Children: requestId, instancesSet
requestId
The ID of the request.
Type: xsd:string
Ancestor: TerminateInstancesResponseType
Children: None
instancesSet
Instances set.
Type: TerminateInstancesResponseInfoType
Ancestor: TerminateInstancesResponseType
Children: item
item
Response item.
Type: TerminateInstancesResponseItemType
Ancestor: instancesSet
Children: instanceId, shutdownState, and previousState
instanceId
Instance ID.
Type: xsd:string
Ancestor: item
Children: None
shutdownState
Shutdown state.
Type: InstanceStateType
Ancestor: item
Children: code, name
code
A 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented:
Type: xsd:int
Ancestor: shutdownState
Children: None
name
The current state of the instance.
Type: xsd:string
Ancestor: shutdownState
Children: None
previousState
Previous state.
Type: InstanceStateType
Ancestor: item
Children: code, name
code
A 16-bit unsigned integer. The high byte is an opaque internal value and should be ignored. The low byte is set based on the state represented:
Type: xsd:int
Ancestor: previousState
Children: None
name
The current state of the instance.
Type: xsd:string
Ancestor: previousState
Children: None
Examples
Example Request
This example terminates the i-3ea74257 instance.
https://ec2.amazonaws.com/?Action=TerminateInstances&InstanceId.1=i-3ea74257&AuthParams
Example Response
<TerminateInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
<instancesSet>
<item>
<instanceId>i-3ea74257</instanceId>
<shutdownState>
<code>32</code>
<name>shutting-down</name>
</shutdownState>
<previousState>
<code>16</code>
<name>running</name>
</previousState>
</item>
</instancesSet>
</TerminateInstancesResponse>