Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CloudWatch Alarme
<a name="cloudwatch-alarms-rule-action"></a>

Die Aktion CloudWatch alarm (`cloudWatchAlarm`) ändert den Status eines CloudWatch Amazon-Alarms. Sie können den Grund für die Zustandsänderung und den Wert in diesem Aufruf angeben. 

## Voraussetzungen
<a name="cloudwatch-alarms-rule-action-requirements"></a>

Diese Regelaktion hat die folgenden Anforderungen:
+ Eine IAM-Rolle, die die Ausführung des `cloudwatch:SetAlarmState` Vorgangs übernehmen AWS IoT kann. Weitere Informationen finden Sie unter [Gewährung eines AWS IoT regeln Sie den Zugriff, den es benötigt](iot-create-role.md).

  In der AWS IoT Konsole können Sie eine Rolle auswählen oder erstellen, um die Ausführung dieser Regelaktion AWS IoT zu ermöglichen.

## Parameters
<a name="cloudwatch-alarms-rule-action-parameters"></a>

Wenn Sie eine AWS IoT Regel mit dieser Aktion erstellen, müssen Sie die folgenden Informationen angeben:

`alarmName`  
Der Name des CloudWatch Alarms.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): API und nur AWS CLI 

`stateReason`  
Der Grund für die Alarmänderung  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`stateValue`  
Der Wert des Alarmzustands. Zulässige Werte: `OK`, `ALARM`, `INSUFFICIENT_DATA`.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`roleArn`  
Die IAM-Rolle, die den Zugriff auf den CloudWatch Alarm ermöglicht. Weitere Informationen finden Sie unter [Voraussetzungen](#cloudwatch-alarms-rule-action-requirements).  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

## Beispiele
<a name="cloudwatch-alarms-rule-action-examples"></a>

Das folgende JSON-Beispiel definiert eine CloudWatch Alarmaktion in einer AWS IoT Regel.

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "cloudwatchAlarm": {
                    "alarmName": "IotAlarm", 
                    "stateReason": "Temperature stabilized.",
                    "stateValue": "OK",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw"
                }
            }
        ]
    }
}
```

## Weitere Informationen finden Sie auch unter
<a name="cloudwatch-alarms-rule-action-see-also"></a>
+ [Was ist Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/) im * CloudWatch Amazon-Benutzerhandbuch*
+ [Verwenden von CloudWatch Amazon-Alarmen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) im * CloudWatch Amazon-Benutzerhandbuch*