AWS ECS icon

AWS ECS

Manage AWS ECS resources

Actions2

Force New Deployment

AI-generated

Summary

Force a new deployment of an existing ECS service within a specified cluster, optionally updating the desired number of running task instances.

Inputs

  • Cluster Name or ID — The name or ARN of the ECS cluster hosting the service. Can be selected from a list of clusters or set via expression.
  • Service Name or ID (required) — The name or ARN of the ECS service to update. Select from available services within the chosen cluster or specify via expression.
  • Desired Count — The desired number of task instances for the service. Set to -1 or leave as default to keep the current count unchanged.

Output shape

a single record as JSON containing the updated service details returned by the AWS ECS UpdateService API call

The operation returns the full AWS service update response as a single JSON object wrapped inside an array. If the Desired Count is set to a value greater than 0, it will update the service's desired count accordingly; otherwise, it remains unchanged.

Examples

Example 1: Force a new deployment on a service keeping the current desired count

Set the Cluster Name, select the Service Name, and leave Desired Count at default (-1).

Example 2: Force a new deployment and update desired task count

Set the Cluster Name, select the Service Name, and specify the Desired Count as the new number of tasks to run.

Links

Discussion