Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . autoscaling ]



Moves the specified instances into the standby state.

For more information, see Temporarily Removing Instances from Your Auto Scaling Group in the Amazon EC2 Auto Scaling User Guide .

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


[--instance-ids <value>]
--auto-scaling-group-name <value>
--should-decrement-desired-capacity | --no-should-decrement-desired-capacity
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--instance-ids (list)

The IDs of the instances. You can specify up to 20 instances.


"string" "string" ...

--auto-scaling-group-name (string)

The name of the Auto Scaling group.

--should-decrement-desired-capacity | --no-should-decrement-desired-capacity (boolean)

Indicates whether to decrement the desired capacity of the Auto Scaling group by the number of instances moved to Standby mode.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


To move instances into standby mode

This example puts the specified instance into standby mode:

aws autoscaling enter-standby --instance-ids i-93633f9b --auto-scaling-group-name my-auto-scaling-group --should-decrement-desired-capacity

The following is example output:

    "Activities": [
            "Description": "Moving EC2 instance to Standby: i-93633f9b",
            "AutoScalingGroupName": "my-auto-scaling-group",
            "ActivityId": "ffa056b4-6ed3-41ba-ae7c-249dfae6eba1",
            "Details": {"Availability Zone": "us-west-2a"},
            "StartTime": "2015-04-12T15:10:23.640Z",
            "Progress": 50,
            "Cause": "At 2015-04-12T15:10:23Z instance i-93633f9b was moved to standby in response to a user request, shrinking the capacity from 2 to 1.",
            "StatusCode": "InProgress"


Activities -> (list)

The activities related to moving instances into Standby mode.


Describes scaling activity, which is a long-running process that represents a change to your Auto Scaling group, such as changing its size or replacing an instance.

ActivityId -> (string)

The ID of the activity.

AutoScalingGroupName -> (string)

The name of the Auto Scaling group.

Description -> (string)

A friendly, more verbose description of the activity.

Cause -> (string)

The reason the activity began.

StartTime -> (timestamp)

The start time of the activity.

EndTime -> (timestamp)

The end time of the activity.

StatusCode -> (string)

The current status of the activity.

StatusMessage -> (string)

A friendly, more verbose description of the activity status.

Progress -> (integer)

A value between 0 and 100 that indicates the progress of the activity.

Details -> (string)

The details about the activity.