# mon-put-data
<a name="cli-mon-put-data"></a>

## 说明
<a name="w2aab9c47b3"></a>

向指定的指标添加指标数据点。此调用将放置给定指标名称的原始值或有效统计数据值的时间序列数据。它支持一次输入一个数据点。

**注意**  
当您使用 `mon-put-data` 命令创建新的指标时，可能需要两分钟时间，之后方可使用 `mon-get-stats` 命令在新的指标上检索统计信息。但是，这可能需要最多 15 分钟时间，之后新的指标会出现在使用 `mon-list-metrics` 命令检索的指标列表中。

## 语法
<a name="w2aab9c47b5"></a>

 ****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] ** 

## 选项
<a name="w2aab9c47b7"></a>


| 名称 | 描述 | 
| --- | --- | 
|  -d, --dimensions "key1=value1,key2=value2..." ``   |  唯一标识指标数据的维度。可以两种方式指定维度，且格式可结合使用或互换使用： [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/AmazonCloudWatch/latest/cli/cli-mon-put-data.html) 类型：映射 有效值：格式为 name=value 的字符串，其中，键是维度的名称，值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。 默认值：不适用 必需：否  | 
|  `-m, --metric-name` `VALUE1,VALUE2,VALUE3...`   |  指标的名称。 类型：字符串 有效值：长度介于 1 到 250 个字符之间的任何有效指标名称。 默认值：不适用 是否必需：是  | 
|  `n, --namespace` `VALUE`   |  指标的命名空间。有关命名空间的更多信息，请参阅 [Amazon 命名空间](https://docs.amazonaws.cn/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html)。 类型：字符串 有效值：长度介于 1 到 250 个字符之间的任何 ANSI 字符串。 默认值：不适用 是否必需：是  | 
|  `-s, --statistic` `Values "key1=value1,key2=value2..."`   |  要为指定的时间戳和指标存储的统计数据。此选项是 `--value` 专用的。至少必须指定 `--statisticValue` 或 `--value` 之一。 类型：映射 有效值：包含所有统计数据名称的所有双精度值的字符串：SampleCount、Sum、Maximum 和 Minimum。所有这些值都必须是介于 1E-130 和 1E130 之间的值。 默认值：不适用 是否必需：是  | 
|  `-t, --timestamp` `VALUE`   |  数据点的时间戳或要记录的指标的观察。时间戳是使用 ISO8601 组合格式指定的。例如，日期和时间 2013 年 7 月 30 日 12:30:00 将表示为：2013-07-30T12:30:00-07:00（太平洋标准时间），或 2013-07-30T19:30:00Z（协调世界时）。 类型：简单 有效值：采用 ISO8601 格式表示的有效时间戳，带有时区偏移或 UTC 指示符。 默认值：当前 UTC 时间。 必需：否  | 
|  `-u, --unit` `VALUE`   |  指标的单位。 类型：枚举 有效值：下列值之一： [\[See the AWS documentation website for more details\]](http://docs.amazonaws.cn/AmazonCloudWatch/latest/cli/cli-mon-put-data.html) 默认值：不适用 必需：否  | 
|  `-v, --value` `VALUE`   |  待记录的单个值。该值将转换为以下形式的统计数据集：SampleCount=1，Sum=VALUE，Minimum=VALUE，Maximum=VALUE。此选项是 `--statisticValues` 专有的。 类型：简单 有效值：所有值必须是介于 1E-130 和 1E130 之间的数字。 默认值：不适用 是否必需：是  | 

## 常用选项
<a name="w2aab9c47b9"></a>


| 名称 | 描述 | 
| --- | --- | 
|  `--aws-credential-file` `VALUE`   |  带有 Amazon 凭证的文件的位置。您可以使用环境变量 `AWS_CREDENTIAL_FILE` 设置此值。如果您定义了环境变量或提供了凭证文件的路径，则该文件必须存在，否则请求将失败。必须使用访问密钥 ID 和秘密访问密钥签署所有 CloudWatch 请求。 类型：字符串 有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。 默认值：使用环境变量 `AWS_CREDENTIAL_FILE`（如果已设置）。  | 
|  `-C, --ec2-cert-file-path` `VALUE`   |  用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 `EC2_CERT` 指定此值。 类型：字符串 有效值：由 Amazon EC2 或 Amazon Identity and Access Management 提供的 PEM 文件的有效路径。 默认值：使用环境变量 `EC2_CERT`（如果已设置）。  | 
|   `--connection-timeout` `VALUE`   |  连接超时值（以秒为单位）。 类型：整数 有效值：任何正数。 默认：30  | 
|   `--delimiter` `VALUE`   |  显示经分隔（长）结果时使用的分隔符。 类型：字符串 有效值：任意字符串。 默认值：逗号 (,)  | 
|   `--headers` ``   |  如果要显示表格结果或分隔结果，请包括列标题。如果要显示 XML 结果，请从服务请求返回 HTTP 标头（如果适用）。 类型：标记 有效值：如果存在，则显示标头。 默认值：默认情况下，`--headers` 选项为关闭状态。  | 
|   `-I, --access-key-id` `VALUE`   |  访问密钥 ID 将与私有密钥共同用于签署请求。其必须与私有密钥结合使用，否则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。 类型：字符串 有效值：有效访问密钥 ID。 默认值：无  | 
|   `-K, --ec2-private-key-file-path` `VALUE`   |  将用于签署请求的私有密钥。使用公有/私有密钥会导致 CLI 使用 SOAP。此请求通过公有证书和私有密钥签署。此参数必须与 `EC2_CERT` 结合使用，否则此值将被忽略。环境变量 `EC2_PRIVATE_KEY` 的值将在设置时使用，并且未指定此选项。如果环境变量 `AWS_CREDENTIAL_FILE` 已设置，或 `--aws-credentials-file` 已使用，则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。 类型：字符串 有效值：有效 ASN.1 私有密钥的路径。 默认值：无  | 
|   `--region` `VALUE`   |  定向到区域请求。您可以使用环境变量 `EC2_REGION` 指定该值。该区域用于创建用于调用 CloudWatch 的 URL，并且必须是有效的亚马逊云科技 (Amazon）区域。 类型：字符串 有效值：任意 Amazon 区域，例如 us-east-1。 默认值：除非 `EC2_REGION` 环境变量已设置，否则为 us-east-1。  | 
|   `S, --secret-key` `VALUE`   |  将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 `--access-key-id` 结合使用，否则此选项将被忽略。 类型：字符串 有效值：您的访问密钥 ID。 默认值：无  | 
|   `--show-empty-fields` ``   |  使用 (nil) 作为占位符显示空字段，以指示未请求此数据。 类型：标记 有效值：无 默认值：默认情况下不显示空字段。  | 
|   `--show-request` ``   |  显示 CLI 用于调用 Amazon 的 URL。 类型：标记 有效值：无 默认：false  | 
|   `--show-table, --show-long, --show-xml, --quiet` ``   |  指定结果的显示方式：表格、分隔（长）、XML 或无输出（无提示）。`--show-table` 显示以固定列宽形式显示数据的子集；`--show-long` 显示以字符分隔的所有返回值；`--show-xml` 是服务的原始返回值；`--quiet` 将抑制所有标准输出。所有选项是互斥的，优先级：`--show-table`、`--show-long`、`--show-xml` 和 `--quiet`。 类型：标记 有效值：无 默认值：`--show-table`  | 
|   `-U, --url` `VALUE`   |  用于联系 CloudWatch 的 URL。您可以使用环境变量 `AWS_CLOUDWATCH_URL` 设置此值。此值与 `--region` 共同用于创建预期的 URL。此选项将覆盖用于服务调用的 URL。 类型：字符串 有效值：有效 HTTP 或 HTTPS URL。 默认值：使用 `AWS_CLOUDWATCH_URL`（如果已设置）中指定的值。  | 

## Output
<a name="w2aab9c47c11"></a>

此命令向指标添加指标数据点。

Amazon CloudWatch CLI 在 stderr 上显示错误。

## 示例
<a name="w2aab9c47c13"></a>

### 示例请求
<a name="w2aab9c47c13b2"></a>

此示例将 `RequestCount` 的统计数据放在 `MyService` 命名空间中。该指标不包含维度，因此代表整个服务的总 RequestCount。测量值是预整合的 statisticValue，表示五个较早的测量值，其最大值是 70，最小值为 30，总和为 250。

```
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
```

### 示例请求
<a name="w2aab9c47c13b4"></a>

此示例将用户特定的 `RequestCount` 测试数据放在 `MyService` 命名空间中。用户和堆栈名称存储为维度，以便将该指标与上面的示例中的服务范围的指标区分开。

```
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
```

## 相关主题
<a name="w2aab9c47c15"></a>

### 下载
<a name="w2aab9c47c15b2"></a>
+ [设置命令行界面](SetupCLI.md)

### 相关操作
<a name="w2aab9c47c15b4"></a>
+ [PutMetricData](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)

### 相关命令
<a name="w2aab9c47c15b6"></a>
+  [mon-put-metric-alarm](cli-mon-put-metric-alarm.md)