Auto Scaling
API Reference (API Version 2011-01-01)


Terminates the specified instance and optionally adjusts the desired group size.

This call simply makes a termination request. The instance is not terminated immediately.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.


The ID of the instance.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 19.

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Required: Yes


Indicates whether terminating the instance also decrements the size of the Auto Scaling group.

Type: Boolean

Required: Yes

Response Elements

The following element is returned by the service.


A scaling activity.

Type: Activity object


For information about the errors that are common to all actions, see Common Errors.


You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

HTTP Status Code: 500


The operation can't be performed because there are scaling activities in progress.

HTTP Status Code: 400


Sample Request

Sample Response

<TerminateInstanceInAutoScalingGroupResponse xmlns="">
      <Description>Terminating EC2 instance: i-12345678</Description>
      <Cause>At 2015-06-14T00:07:30Z instance i-12345678 was taken out of service in response to a user request, shrinking the capacity from 4 to 3.</Cause>
      <Details>{"Availability Zone":"us-east-1a","SubnetID":"subnet-12345678"}</Details>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: