Amazon EC2 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 up (increase the number of instances) or scale down (decrease the number of instances) your cluster.


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


ecs-cli scale --capability-iam --size n [--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

Show the help text for the specified command.

Required: No



This example scales the current cluster to 2 container instances.

$ ecs-cli scale --capability-iam --size 2 INFO[0001] Waiting for your cluster resources to be updated INFO[0001] Cloudformation stack status stackStatus=UPDATE_IN_PROGRESS