本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# CloudWatchAlarm
<a name="rule-reference-CloudWatchAlarm"></a>

创建条件时，可以添加 `CloudWatchAlarm` 规则。本节提供对规则参数的参考。有关规则和条件的更多信息，请参阅[阶段条件是如何运作的？](concepts-how-it-works-conditions.md)。

您必须已经在 Amazon 中创建了警报 CloudWatch 作为单独的资源。

**Topics**
+ [规则类型](#rule-reference-CloudWatchAlarm-type)
+ [配置参数](#rule-reference-CloudWatchAlarm-config)
+ [规则配置示例](#rule-reference-CloudWatchAlarm-example)
+ [另请参阅](#rule-reference-CloudWatchAlarm-links)

## 规则类型
<a name="rule-reference-CloudWatchAlarm-type"></a>
+ 类别：`Rule`
+ 拥有者：`AWS`
+ 提供方：`CloudWatchAlarm`
+ 版本：`1`

## 配置参数
<a name="rule-reference-CloudWatchAlarm-config"></a>

**AlarmName**  
是否必需：是  
 CloudWatch 警报的名称。这是在中创建的单独资源 CloudWatch。

**AlarmStates**  
必需：否  
要监控的规则所需的 CloudWatch 警报状态。有效值：ALARM、OK 和 INSUFFICIENT\$1DATA。

**WaitTime**  
必需：否  
运行规则结果前允许状态更改的等待时间（分钟）。例如，配置在应用规则结果之前等待 20 分钟让警报状态变为 OK。

## 规则配置示例
<a name="rule-reference-CloudWatchAlarm-example"></a>

------
#### [ YAML ]

```
rules:
    - name: MyMonitorRule
      ruleTypeId:
        category: Rule
        owner: AWS
        provider: CloudWatchAlarm
        version: '1'
      configuration:
        AlarmName: CWAlarm
        WaitTime: '1'
      inputArtifacts: []
      region: us-east-1
```

------
#### [ JSON ]

```
                            "rules": [
                                {
                                    "name": "MyMonitorRule",
                                    "ruleTypeId": {
                                        "category": "Rule",
                                        "owner": "AWS",
                                        "provider": "CloudWatchAlarm",
                                        "version": "1"
                                    },
                                    "configuration": {
                                        "AlarmName": "CWAlarm",
                                        "WaitTime": "1"
                                    },
                                    "inputArtifacts": [],
                                    "region": "us-east-1"
                                }
                            ]
                        }
```

------

## 另请参阅
<a name="rule-reference-CloudWatchAlarm-links"></a>

以下相关资源可在您使用此规则时为您提供帮助。
+ [创建“失败时”条件](stage-conditions.md#stage-conditions-onfailure) – 本节介绍使用警报规则创建“失败时”条件的步骤。