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-describe-alarm-history ## Description Ruft den Verlauf für den angegebenen Alarm ab. Sie können Alarme nach Datumsbereich oder Elementtyp filtern. Wenn Sie keinen Alarmnamen angeben, sendet Amazon Historien für all Ihre Alarme CloudWatch zurück. **Anmerkung** Amazon CloudWatch speichert den Verlauf der aktiven und gelöschten Alarme zwei Wochen lang. ## Syntax ****mon-describe-alarm-history** [AlarmNames [*AlarmNames* ...]] [--end-date *value*] [--history-item-type *value*] [--start-date *value*] [Common Options] ** ## Optionen | Name | Description | | --- | --- | | `AlarmName` `AlarmNames` | Die Namen der Alarme, getrennt durch Leerzeichen. Wenn Sie keinen Alarmnamen angeben, gibt dieser Befehl den Verlauf aller Ihrer Alarme zurück. Sie können diesen Wert auch über `--alarm-name` festlegen. Typ: Argument Gültige Werte: Jede beliebige Zeichenkette mit einer Länge von 1 bis 255 Zeichen. Standard: n/a Erforderlich: Nein | | `--end-date` `VALUE` | Das Ende des Datumsbereichs für den Verlauf. Typ: Datum Gültige Werte: Datum im YYYY-MM-DD Format. Standard: Das aktuelle Datum. Erforderlich: Nein | | `--history-item-type` `VALUE` | Der Typ der abzurufenden Verlaufselemente. Standardmäßig werden alle Typen zurückgegeben. Typ: Aufzählung Gültige Werte: ConfigurationUpdate, StateUpdate, oder Action Standard: Es werden alle Typen zurückgegeben. Erforderlich: Nein | | `--start-date` `VALUE` | Der Anfang des Datumsbereichs für den Verlauf. Standardmäßig erstreckt sie sich auf den gesamten verfügbaren Verlauf. Typ: Datum Gültige Werte: Datum im YYYY-MM-DD Format. Standard: Alle verfügbaren Verlaufsdaten. 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 gibt eine Tabelle zurück, die Folgendes enthält: + ALARM – Der Name des Alarms. + TIMESTAMP – Der Zeitstempel. + TYP — Der Ereignistyp, einer von ConfigurationUpdate StateUpdate und die Aktion. + SUMMARY – Eine für Menschen lesbare Zusammenfassung des Geschichtsereignisses. + DATA – Detaillierte Daten über das Ereignis im maschinenlesbaren JSON-Format. Diese Spalte erscheint nur in der Ansicht --show-long. Die Amazon CloudWatch CLI zeigt Fehler auf stderr an. ## Beispiele ### Beispielanforderung Dieses Beispiel beschreibt alle Verlaufspunkte für den Alarm my-alarm. ``` mon-describe-alarm-history--alarm-name my-alarm --headers ``` Dies ist eine exemplarische Ausgabe dieses Befehls. ``` ALARM TIMESTAMP TYPE SUMMARY my-alarm 2013-05-07T18:46:16.121Z Action Published a notification to arn:aws:sns:... my-alarm 2013-05-07T18:46:16.118Z StateUpdate Alarm updated from INSUFFICIENT_DATA to OK my-alarm 2013-05-07T18:46:07.362Z ConfigurationUpdate Alarm "my-alarm" created ``` ## Verwandte Themen ### Download + [Einrichtung der Befehlszeilenschnittstelle](SetupCLI.md) ### Zugehörige Aktion + [DescribeAlarmHistory](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html) ### Zugehörige Befehle + [mon-describe-alarms](cli-mon-describe-alarms.md) + [mon-describe-alarms-for-Metrik](cli-mon-describe-alarms-for-metric.md)