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 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 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.


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

Shows the help text for the specified command.

Required: No



This example scales the current cluster to two 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