Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AWS::ECS::Service DeploymentAlarms

Focus mode
AWS::ECS::Service DeploymentAlarms - AWS CloudFormation
Filter View

One of the methods which provide a way for you to quickly identify when a deployment has failed, and then to optionally roll back the failure to the last working deployment.

When the alarms are generated, Amazon ECS sets the service deployment to failed. Set the rollback parameter to have Amazon ECS to roll back your service to the last completed deployment after a failure.

You can only use the DeploymentAlarms method to detect failures when the DeploymentController is set to ECS (rolling update).

For more information, see Rolling update in the Amazon Elastic Container Service Developer Guide .

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "AlarmNames" : [ String, ... ], "Enable" : Boolean, "Rollback" : Boolean }

YAML

AlarmNames: - String Enable: Boolean Rollback: Boolean

Properties

AlarmNames

One or more CloudWatch alarm names. Use a "," to separate the alarms.

Required: Yes

Type: Array of String

Update requires: No interruption

Enable

Determines whether to use the CloudWatch alarm option in the service deployment process.

Required: Yes

Type: Boolean

Update requires: No interruption

Rollback

Determines whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

Required: Yes

Type: Boolean

Update requires: No interruption

See also

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.