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-data
## Description
Fügt Metrik-Datenpunkte zu der angegebenen Metrik hinzu. Dieser Aufruf gibt Zeitreihendaten aus, entweder für den Rohwert oder für gültige statistische Werte eines bestimmten Metriknamens. Es unterstützt die Eingabe jeweils eines einzelnen Datenpunktes.
**Anmerkung**
Wenn Sie eine neue Metrik mit Hilfe des `mon-put-data`-Befehls erstellen, kann es bis zu zwei Minuten dauern, bis Sie Statistiken über die neue Metrik mit dem Befehl `mon-get-stats` abrufen können. Es kann jedoch bis zu 15 Minuten dauern, bis die neue Metrik in der Liste der Metriken erscheint, die mit dem Befehl `mon-list-metrics` abgerufen wurde.
## Syntax
****mon-put-data** --metric-name {{value}}[--namespace {{value}} [--dimensions "key1={{value1}},key2={{value2}}..."] [--statisticValues "key1={{value1}},key2={{value2}}..."] [--timestamp {{value}}] [--unit {{value}}] [--value {{value}}] [Common Options] **
## Optionen
| Name | Description |
| --- | --- |
| -d, --dimensions "key1=value1,key2=value2..." `` | Die Dimensionen, die die Metrikdaten eindeutig identifizieren. Sie können die Dimensionen auf zwei Arten festlegen und die Formate können kombiniert oder austauschbar verwendet werden:+ Eine Option pro Dimension: --dimensions "key1=value1" --dimensions "key2=value2".
+ Alles in einer Option: --dimensions "key1=value1,key2=value2".
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 |
| `-m, --metric-name` `VALUE1,VALUE2,VALUE3...` | Name der Metrik.
Typ: Zeichenfolge
Gültige Werte: Jeder gültige Metrikname zwischen 1 und 250 Zeichen.
Standard: n/a
Erforderlich: Ja |
| `n, --namespace` `VALUE` | Der Namespace der Metrik. 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 |
| `-s, --statistic` `Values "key1=value1,key2=value2..."` | Die Statistiken, die für den angegebenen Zeitstempel und die angegebene Metrik gespeichert werden sollen. Diese Option gilt ausschließlich für `--value`. Mindestens `--statisticValue` oder `--value` muss angegeben werden.
Typ: Zuordnung
Gültige Werte: Eine Zeichenfolge, die alle Doppelwerte für alle Statistiknamen enthält: SampleCount, Sum, Maximum und Minimum. Alle diese Werte müssen einen Wert zwischen 1 E-130 und 1E130 haben.
Standard: n/a
Erforderlich: Ja |
| `-t, --timestamp` `VALUE` | Der Zeitstempel des Datenpunktes oder der Beobachtung für die aufzuzeichnende Metrik. Zeitstempel werden im kombinierten Format ISO8601 angegeben. Das Datum und die Uhrzeit des 30. Juli 2013 um 12:30 Uhr PST würden beispielsweise als 30.07.2013 oder in UTC: 2013-07-30 T12:30:00-07:00 dargestellt. T19:30:00Z
Typ: Einfach
Gültige Werte: Ein gültiger Zeitstempel im Format ISO8601 mit Zeitzonenabweichung oder UTC-Indikator.
Standard: Die aktuelle UTC-Zeit.
Erforderlich: Nein |
| `-u, --unit` `VALUE` | Die Einheit für die Metrik.
Typ: Aufzählung
Gültige Werte: Einer der folgenden:+ Sekunden
+ Mikrosekunden
+ Millisekunden
+ Bytes
+ Kilobytes
+ Megabyte
+ Gigabytes
+ Terabytes
+ Bits
+ Kilobits
+ Megabits
+ Gigabits
+ Terabits
+ Prozent
+ Anzahl
+ Bytes/Second
+ Kilobytes/Second
+ Megabytes/Second
+ Gigabytes/Second
+ Terabytes/Second
+ Bits/Second
+ Kilobits/Second
+ Megabits/Second
+ Gigabits/Second
+ Terabits/Second
+ Count/Second
+ Keine
Standard: n/a
Erforderlich: Nein |
| `-v, --value` `VALUE` | Ein Einzelwert, der aufgezeichnet werden soll. Der Wert wird in einen Statistiksatz der folgenden Form übersetzt: SampleCount =1, Summe=Wert, Minimum=Wert, Maximum=Wert. Diese Option gilt ausschließlich für `--statisticValues`.
Typ: Einfach
Gültige Werte: Alle Werte müssen eine Zahl zwischen 1 und 1E130 sein. E-130
Standard: n/a
Erforderlich: Ja |
## 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 der EC2-Zertifikatdatei zum Signieren von Anforderungen. Sie können die Umgebungsvariable `EC2_CERT` verwenden, um diesen Wert anzugeben.
Typ: Zeichenfolge
Gültige Werte: Ein gültiger Dateipfad zur PEM-Datei, die von Amazon EC2 oder bereitgestellt wird. 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 werden, 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 bewirkt, dass die CLI SOAP verwendet. 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 werden, andernfalls wird die Anfrage abgelehnt.
Typ: Zeichenfolge
Gültige Werte: Der Pfad zu einem gültigen ASN.1 privaten 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 zu erstellen, die für den Aufruf verwendet wird 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 die Kontaktaufnahme 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
Mit diesem Befehl werden Metrik-Datenpunkte zu einer Metrik hinzugefügt.
Die Amazon CloudWatch CLI zeigt Fehler auf stderr an.
## Beispiele
### Beispielanforderung
In diesem Beispiel werden Statistikdaten für `RequestCount` im `MyService`-Namespace erstellt. Die Metrik enthält keine Dimensionen und stellt somit den Gesamtwert für den RequestCount gesamten Service dar. Die Messung ist ein voraggregierter statistischer Wert, der fünf frühere Messungen darstellt, deren Maximum 70 war, deren Minimum 30 war und deren Summe 250 war.
```
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
```
### Beispielanforderung
In diesem Beispiel werden benutzerspezifische `RequestCount`-Testdaten im `MyService`-Namespace erstellt. Der Benutzer- und Stapelname werden als Dimensionen gespeichert, um diese Metrik von der serviceweiten Metrik im obigen Beispiel zu unterscheiden.
```
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
```
## Verwandte Themen
### Download
+ [Einrichtung der Befehlszeilenschnittstelle](SetupCLI.md)
### Zugehörige Aktion
+ [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)
### Zugehöriger Befehl
+ [mon-put-metric-alarm](cli-mon-put-metric-alarm.md)