本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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\_DATA。

**WaitTime**  
必要：否  
在執行規則結果之前，允許狀態變更的等待時間，以分鐘為單位。例如，設定 20 分鐘等待警示狀態變更為確定，再套用規則結果。

## 範例規則組態
<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) – 本節提供使用警示規則建立失敗時條件的步驟。