Amazon Elastic Container Service
Developer Guide (API Version 2014-11-13)

ecs-cli scale

Modifies the number of container instances in your cluster. This command changes the desired and maximum instance count in the Auto Scaling group created by the ecs-cli up command. You can use this command to scale out (increase the number of instances) or scale in (decrease the number of instances) your cluster.


The Amazon ECS CLI can only manage tasks, services, and container instances that were created with the Amazon ECS CLI. To manage tasks, services, and container instances that were not created by the Amazon ECS CLI, use the AWS Command Line Interface or the AWS Management Console.


Some features described may only be available with the latest version of the Amazon ECS CLI. For more information about obtaining the latest version, see Installing the Amazon ECS CLI.


ecs-cli scale --capability-iam --size n [--cluster cluster_name] [--region region] [--help]


Name Description


Acknowledges that this command may create IAM resources.

Required: Yes

--size n

Specifies the number of instances to maintain in your cluster.

Type: Integer

Required: Yes

--help, -h

Shows the help text for the specified command.

Required: No



This example scales the current cluster to two container instances.

ecs-cli scale --size 2 --capability-iam


INFO[0001] Waiting for your cluster resources to be updated INFO[0001] Cloudformation stack status stackStatus=UPDATE_IN_PROGRESS

On this page: