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. # mon-put-metric-alarm ## Description Erstellt oder aktualisiert einen Alarm und ordnet ihn der angegebenen CloudWatch Metrik zu. Sie können diesen Befehl auch verwenden, um einer oder mehreren Ressourcen von Amazon Simple Notification Service (Amazon SNS) einem Alarm zuzuordnen. Wenn dieser Vorgang einen Alarm auslöst, wird der Alarmzustand sofort auf INSUFFICIENT\$1DATA gesetzt. Der Alarm wird ausgewertet und entsprechend eingestellt. StateValue Alle damit verbundenen Aktionen werden dann ausgeführt. StateValue **Anmerkung** Wird ein vorhandener Alarm aktualisiert, StateValue bleibt unverändert. ## Syntax ****mon-put-metric-alarm** AlarmName --comparison-operator *value* --evaluation-periods *value* --metric-name *value* --namespace *value* --period *value* [--statistic *value*] [--extendedstatistic *value*] --threshold *value* [--actions-enabled *value*] [--alarm-actions *value*[,*value*...] ] [--alarm-description *value*] [--dimensions "key1=*value1*,key2=*value2*..."] [--ok-actions *value*[,*value*...] ] [--unit *value*] [--insufficient-data-actions *value*[,*value*...]] [Common Options] ** ## Optionen | Name | Description | | --- | --- | | `AlarmName` `` | Der Name des zu aktualisierenden oder zu erstellenden Alarms. Der Name muss innerhalb Ihres AWS Kontos eindeutig sein. Sie können diesen Wert auch über `--alarm-name` festlegen. Typ: Argument Gültige Werte: Eine UTF-8-Zeichenkette. Standard: n/a Erforderlich: Ja | | `--actions-enabled` `VALUE` | Gibt an, ob Aktionen ausgeführt werden sollen, wenn der Alarm den Zustand wechselt. Typ: Boolescher Wert Gültige Werte: True oder False Standard: True Erforderlich: Nein | | `--alarm-actions` `VALUE1,VALUE2,VALUE3... ` | Die Aktionen (bis zu 5), die ausgeführt werden sollen, wenn dieser Alarm von jedem anderen Zustand in einen ALARM-Zustand übergeht. Jede Aktion wird als Amazon-Ressourcenname (ARN) angegeben. Mithilfe von Alarmaktionen können Sie Beiträge zu einem Amazon SNS SNS-Thema veröffentlichen, eine Amazon EC2 Auto Scaling Scaling-Richtlinie aktivieren oder eine EC2 Amazon-Instance beenden, beenden oder wiederherstellen. Wenn Sie ein AWS Identity and Access Management (IAM-) Konto verwenden, um einen Alarm zu erstellen oder zu ändern, benötigen Sie die folgenden EC2 Amazon-Berechtigungen: `ec2:DescribeInstanceStatus`und `ec2:DescribeInstances` für alle Alarme auf EC2 Amazon-Instance-Statusmetriken. `ec2:StopInstances` für Alarme mit Aktionen zum Anhalten. `ec2:TerminateInstances` für Alarme mit Aktionen zum Beenden. `ec2:DescribeInstanceRecoveryAttribute` und `ec2:RecoverInstances` für Alarme mit Aktionen zum Wiederherstellen. Wenn Sie über read/write Berechtigungen für Amazon, CloudWatch aber nicht für Amazon verfügen EC2, können Sie trotzdem einen Alarm erstellen, aber die Aktionen „Beenden“ oder „Beenden“ werden auf der EC2 Amazon-Instance nicht ausgeführt. Wenn Sie jedoch später die Erlaubnis erhalten, das zugehörige Amazon zu verwenden EC2 APIs, werden die zuvor erstellten Alarmaktionen ausgeführt. Weitere Informationen zu IAM-Berechtigung finden Sie unter [Berechtigungen und Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/PermissionsAndPolicies.html) im *IAM-Benutzerhandbuch*. Wenn Sie eine IAM-Rolle verwenden (z. B. ein EC2 Amazon-Instance-Profil), können Sie die Instance nicht mithilfe von Alarmaktionen stoppen oder beenden. Sie können jedoch weiterhin den Alarmstatus sehen und andere Aktionen wie Amazon SNS-Benachrichtigungen oder Amazon EC2 Auto Scaling-Richtlinien ausführen. Wenn Sie temporäre Sicherheitsanmeldedaten verwenden, die mit AWS -Security-Token-Service (AWS STS) gewährt wurden, können Sie eine EC2 Amazon-Instance nicht mithilfe von Alarmaktionen stoppen oder beenden. Typ: Zeichenfolge Gültige Werte: Ein ARN für ein Amazon SNS SNS-Thema, eine Auto Scaling Scaling-Richtlinie oder ein ARN zum Stoppen, Beenden oder Wiederherstellen einer EC2 Amazon-Instance. Standard: n/a Erforderlich: Nein | | `--alarm-description` `VALUE` | Die Beschreibung des Alarms. Typ: Zeichenfolge Gültige Werte: Jede beliebige Unicode-Zeichenkette mit einer Länge von 1 bis 255 Zeichen. Standard: n/a Erforderlich: Nein | | `--comparison-operator` `VALUE` | Der Vergleichsoperator, mit dem ein Datenpunkt mit dem Schwellenwert verglichen wird. Typ: Aufzählung Gültige Werte: einer von GreaterThanOrEqualToThreshold, GreaterThanThreshold LessThanThreshold, oder LessThanOrEqualToThreshold Standard: n/a Erforderlich: Ja | | `--dimensions` `"key1=value1,key2=value2..."` | Die Dimensionen der zu erstellenden Metrik, für die Sie einen Alarm erstellen möchten. Sie können die Dimensionen auf zwei Arten festlegen und die Formate können kombiniert oder austauschbar verwendet werden: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonCloudWatch/latest/cli/cli-mon-put-metric-alarm.html) Typ: Zuordnung Gültige Werte: Eine Zeichenkette des Formats name=value, wobei der Schlüssel der Name der Dimension und der Wert der Wert der Dimension ist. Die Dimensionsnamen und ‑werte müssen eine ANSI-Zeichenkette mit einer Länge von 1 bis 250 Zeichen sein. Es sind maximal 10 Dimensionen zulässig. Standard: n/a Erforderlich: Nein | | `--evaluation-periods` `VALUE` | Die Anzahl der aufeinander folgenden Zeiträume, für die der Wert der Metrik mit dem Schwellenwert verglichen wird, um den Alarmstatus zu bestimmen. Typ: Ganzzahl Gültige Werte: Eine Zahl größer als Null. Standard: n/a Erforderlich: Ja | | `--metric-name` `VALUE` | Der Name der Metrik, bei der ein Alarm ausgelöst werden soll. Typ: Argument Gültige Werte: Eine ANSI-Zeichenkette mit einer Länge von 1 bis 250 Zeichen. Standard: n/a Erforderlich: Ja | | `--namespace` `VALUE` | Der Namespace der Metrik, bei der ein Alarm ausgelöst werden soll. Weitere Informationen zu Namespaces finden Sie unter [AWS -Namespaces](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html). Typ: Zeichenfolge Gültige Werte: Eine ANSI-Zeichenkette mit einer Länge von 1 bis 250 Zeichen. Standard: n/a Erforderlich: Ja | | `--ok-actions` `VALUE1,VALUE2,VALUE3...` | Die Aktionen (bis zu 5), die ausgeführt werden sollen, wenn dieser Alarm von jedem anderen Zustand in einen OK-Zustand übergeht. Jede Aktion wird als Amazon-Ressourcenname (ARN) angegeben. Typ: Zeichenfolge Gültige Werte: Ein gültiger ARN-Identifikator. Standard: n/a Erforderlich: Nein | | `--period` `VALUE` | Der Zeitraum der Metrik, nach der ein Alarm ausgelöst werden soll (in Sekunden). Typ: Argument Gültige Werte: Eine Zahl, in Sekunden, die ein Vielfaches von 60 Sekunden ist. Standard: n/a Erforderlich: Ja | | `--statistic` `VALUE` | Die Statistik der Metrik, bei der ein Alarm ausgelöst werden soll. Typ: Aufzählung Gültige Werte: SampleCount, Durchschnitt, Summe, Minimum oder Maximum Standard: n/a Erforderlich: Sie müssen --statistic oder --extendedstatistic angeben. | | `--extendedstatistic` `VALUE` | Die Perzentilstatistik der Metrik, bei der ein Alarm ausgelöst werden soll. Typ: Zeichenfolge Gültige Werte: Beliebige Perzentile mit bis zu zwei Dezimalstellen (z. B. p95.45). Standard: n/a Erforderlich: Sie müssen --statistic oder --extendedstatistic angeben. | | `--threshold` `VALUE` | Der Schwellenwert, mit dem Datenpunkte verglichen werden, um den Alarmzustand zu bestimmen. Type: Double Gültige Werte: Ein Double-Wert. Alle Werte müssen eine Zahl zwischen 1E-130 und 1E130 sein. Standard: n/a Erforderlich: Ja | | `--unit` `VALUE` | Die Einheit der Metrik, bei der ein Alarm ausgelöst werden soll. Typ: Aufzählung Gültige Werte: Einer der folgenden: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonCloudWatch/latest/cli/cli-mon-put-metric-alarm.html) Standard: n/a Erforderlich: Nein | | `--insufficient-data-actions` `VALUE1,VALUE2,VALUE3...` | Die Aktionen (bis zu 5), die ausgeführt werden sollen, wenn dieser Alarm von jedem anderen Zustand in einen INSUFFICIENT\$1DATA-Zustand übergeht. Jede Aktion wird als Amazon-Ressourcenname (ARN) angegeben. Typ: Zeichenfolge Gültige Werte: Ein gültiger ARN-Identifikator. Standard: n/a Erforderlich: Nein | ## Allgemeine Optionen | Name | Description | | --- | --- | | `--aws-credential-file` `VALUE` | Der Speicherort der Datei mit Ihren AWS Anmeldeinformationen. Sie können diesen Wert festlegen, indem Sie die Umgebungsvariable `AWS_CREDENTIAL_FILE` verwenden. Wenn Sie die Umgebungsvariable definieren oder den Pfad zur Anmeldeinformationsdatei angeben, muss die Datei vorhanden sein, sonst schlägt die Anforderung fehl. Alle CloudWatch Anfragen müssen mit Ihrer Zugangsschlüssel-ID und Ihrem geheimen Zugriffsschlüssel signiert werden. Typ: Zeichenfolge Gültige Werte: Ein gültiger Pfad zu einer Datei, in der die Zugriffsschlüssel-ID und der geheime Zugriffsschlüssel enthalten sind. Standard: Verwendet die Umgebungsvariable `AWS_CREDENTIAL_FILE`, falls festgelegt. | | `-C, --ec2-cert-file-path` `VALUE` | Der Speicherort Ihrer EC2 Zertifikatsdatei zum Signieren von Anfragen. Sie können die Umgebungsvariable `EC2_CERT` verwenden, um diesen Wert anzugeben. Typ: Zeichenfolge Gültige Werte: Ein gültiger Dateipfad zu der von Amazon bereitgestellten PEM-Datei EC2 oder AWS Identity and Access Management. Standard: Verwendet die Umgebungsvariable `EC2_CERT`, falls festgelegt. | | `--connection-timeout` `VALUE` | Der Verbindungs-Timeoutwert in Sekunden. Typ: Ganzzahl Zulässige Werte: Jede beliebige positive Zahl. Standard: 30 | | `--delimiter` `VALUE` | Das Trennzeichen, das beim Anzeigen getrennter (langer) Ergebnisse verwendet wird. Typ: Zeichenfolge Gültige Werte: Beliebige Zeichenfolge. Standard: Komma (,) | | `--headers` `` | Wenn Sie tabellarische oder durch Trennzeichen getrennte Ergebnisse anzeigen, schließen Sie die Spaltenüberschriften ein. Wenn Sie XML-Ergebnisse anzeigen, geben Sie ggf. die HTTP-Header aus der Serviceanforderung zurück. Typ: Flag Gültige Werte: Wenn vorhanden, zeigt Kopfzeilen an. Standard: Die `--headers`-Option ist standardmäßig deaktiviert. | | `-I, --access-key-id` `VALUE` | Die Zugriffsschlüssel-ID, die zum Signieren der Abfrage in Verbindung mit dem geheimen Schlüssel verwendet wird. Dieser Parameter muss in Verbindung mit --secret-key verwendet werden, andernfalls wird die Option ignoriert. Alle Anfragen an CloudWatch müssen signiert sein, andernfalls wird die Anfrage abgelehnt. Typ: Zeichenfolge Zulässige Werte: Eine gültige Zugriffsschlüssel-ID. Standard: keiner | | `-K, --ec2-private-key-file-path` `VALUE` | Der private Schlüssel, der zum Signieren der Abfrage verwendet wird. Die Verwendung von public/private Schlüsseln veranlasst die CLI, SOAP zu verwenden. Die Abfrage wird mit einem öffentlichen Zertifikat und einem privaten Schlüssel signiert. Dieser Parameter muss in Verbindung mit `EC2_CERT` verwendet werden, andernfalls wird der Wert ignoriert. Der Wert der Umgebungsvariable `EC2_PRIVATE_KEY` wird verwendet, wenn sie festgelegt ist und diese Option nicht angegeben ist. Diese Option wird ignoriert, wenn die Umgebungsvariable `AWS_CREDENTIAL_FILE` festgelegt ist, oder `--aws-credentials-file` verwendet wird. Alle Anfragen an CloudWatch müssen signiert sein, andernfalls wird die Anfrage abgelehnt. Typ: Zeichenfolge Gültige Werte: Der Pfad zu einem gültigen privaten ASN.1 Schlüssel. Standard: keiner | | `--region` `VALUE` | Die Anforderungen an die Region werden weitergeleitet. Sie können die Umgebungsvariable `EC2_REGION` verwenden, um den Wert anzugeben. Die Region wird verwendet, um die URL für den Anruf zu erstellen CloudWatch, und muss eine gültige Amazon Web Services (AWS) -Region sein. Typ: Zeichenfolge Gültige Werte: Jede AWS Region, z. B. us-east-1. Standard: us-east-1, es sei denn, die `EC2_REGION`-Umgebungsvariable ist festgelegt. | | `S, --secret-key` `VALUE` | Der geheime Zugriffsschlüssel, der zum Signieren der Anforderung in Verbindung mit einer Zugriffsschlüssel-ID verwendet wird. Dieser Parameter muss in Verbindung mit `--access-key-id` verwendet werden, andernfalls wird diese Option ignoriert. Typ: Zeichenfolge Zulässige Werte: Ihre Zugriffsschlüssel-ID. Standard: keiner | | `--show-empty-fields` `` | Zeigt leere Felder an, die (nil) als Platzhalter verwenden, um anzuzeigen, dass diese Daten nicht angefordert wurden. Typ: Flag Zulässige Werte: Keine Standard: Leere Felder werden standardmäßig nicht angezeigt. | | `--show-request` `` | Zeigt die URL an, die die CLI zum Aufrufen von AWS verwendet. Typ: Flag Zulässige Werte: Keine Standard: false | | `--show-table, --show-long, --show-xml, --quiet` `` | Gibt an, wie die Ergebnisse angezeigt werden: in einer Tabelle, getrennt (lang), XML oder keine Ausgabe (still). Die `--show-table`-Anzeige zeigt eine Teilmenge der Daten in fester Spaltenbreite; `--show-long` zeigt alle zurückgegebenen Werte, die durch ein Zeichen getrennt sind; `--show-xml` ist der Rohertrag des Services; und `--quiet` unterdrückt alle Standardausgaben. Alle Optionen schließen sich gegenseitig aus, wobei die Priorität `--show-table`, `--show-long`, `--show-xml` und `--quiet` ist. Typ: Flag Zulässige Werte: Keine Standard: `--show-table` | | `-U, --url` `VALUE` | Die URL, die für den Kontakt verwendet wurde. CloudWatch Sie können diesen Wert festlegen, indem Sie die Umgebungsvariable `AWS_CLOUDWATCH_URL` verwenden. Dieser Wert wird in Verbindung mit `--region` verwendet, um die erwartete URL zu erstellen. Diese Option überschreibt die URL für den Serviceaufruf. Typ: Zeichenfolge Gültige Werte: Eine gültige HTTP- oder HTTPS-URL. Standard: Verwendet den Wert, der in `AWS_CLOUDWATCH_URL` angegeben ist, falls festgelegt. | ## Ausgabe Dieser Befehl erstellt oder aktualisiert einen Alarm, der der angegebenen Metrik zugeordnet ist. Die Amazon CloudWatch CLI zeigt Fehler auf stderr an. ## Beispiele ### Beispielanforderung In diesem Beispiel wird ein Alarm ausgelöst, der eine Meldung zu einem Thema veröffentlicht, wenn die CPU-Auslastung einer EC2 Instance in drei aufeinanderfolgenden Zeiträumen von einer Minute 90 Prozent übersteigt. ``` mon-put-metric-alarm --alarm-name my-alarm --alarm-description "some desc" \ --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 60 --threshold 90 \ --comparison-operator GreaterThanThreshold --dimensions InstanceId=i-abcdef --evaluation-periods 3 \ --unit Percent --alarm-actions arn:aws:sns:us-east-1:1234567890:my-topic ``` ## Verwandte Themen ### Download + [Einrichtung der Befehlszeilenschnittstelle](SetupCLI.md) ### Zugehörige Aktion + [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html) ### Zugehöriger Befehl + [mon-put-data](cli-mon-put-data.md)