本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
mon-put-data
Description
向指定的指标添加指标数据点。此调用将放置给定指标名称的原始值或有效统计数据值的时间序列数据。它支持一次输入一个数据点。
当您使用 mon-put-data 命令创建新的指标时，可能需要两分钟时间，之后方可使用 mon-get-stats 命令在新的指标上检索统计信息。但是，这可能需要最多 15 分钟时间，之后新的指标会出现在使用 mon-list-metrics 命令检索的指标列表中。
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]
Options
| 名称 | 描述 |
|---|---|
|
-d, --dimensions "key1=value1,key2=value2..." |
唯一标识指标数据的维度。可以两种方式指定维度，且格式可结合使用或互换使用：
类型: 映射 有效值：格式为 name=value 的字符串，其中，键是维度的名称，值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。 默认值：不适用 ：必需 否 |
|
|
指标的名称。 类型: 字符串 有效值：长度介于 1 到 250 个字符之间的任何有效指标名称。 默认值：不适用 ：必需 是 |
|
|
指标的命名空间。有关命名空间的更多信息，请参阅 Amazon 命名空间。 类型: 字符串 有效值：长度介于 1 到 250 个字符之间的任何 ANSI 字符。 默认值：不适用 ：必需 是 |
|
|
要为指定的时间戳和指标存储的统计数据。此选项是 类型: 映射 有效值：包含所有统计数据名称的所有双精度值的字符串：SampleCount 结构、Sum、Max慕大值和 Max慕大值。所有这些值都必须是介于 1E-130 和 1E130 之间的值。 默认值：不适用 ：必需 是 |
|
|
数据点的时间戳或要记录的指标的观察。时间戳是使用 ISO8601 组合格式指定的。例如，日期和时间 2013 年 7 月 30 日 12:30:00 将表示为 2013-07-30:00（太平洋标准时间），或 2013-07-30:00（太平洋标准时间）：TRUE TRUE ST. 类型: 简便 有效值：采用 ISO8601 格式表示的有效时间戳，带有时区偏移或 UTC 指示符。 默认值：当前 UTC 时间。 ：必需 否 |
|
|
指标的单位。 类型: 枚举 有效值：下列情况之一：
默认值：不适用 ：必需 否 |
|
|
待记录的单个值。该值将转换为以下形式的统计数据集：Samum=1，Sum=VALUE，Minimum=VALUE，Maximum=VALUE，Maximum=VALUE。此选项是
类型: 简便 有效值：所有值必须是介于 1E-130 和 1E130 之间的数字。 默认值：不适用 ：必需 是 |
常用选项
| 名称 | 描述 |
|---|---|
|
|
文件的位置，Amazon凭证。您可以使用环境变量设置此值。 类型: 字符串 有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。 默认值：使用环境变量 |
|
|
用于签名请求的 EC2 证书文件的位置。可以使用环境变量 类型: 字符串 有效值：由 Amazon EC2 或 AWS Identity and Access Management 提供的 PEM 文件的有效文件路径。 默认值：使用环境变量 |
|
|
连接超时值 (以秒为单位)。 类型: 整数 有效值：正数。 默认值：30 |
|
|
显示分隔符（长度）结果时使用的分隔符。 类型: 字符串 有效值：任何字符串。 默认值：逗号 (,) |
|
|
如果要显示表格结果或分隔结果，请包括列标题。如果要显示 XML 结果，请从服务请求返回 HTTP 标头（如果适用）。 类型: 标记 有效值：如果存在，则显示标题。 默认值：这些区域有： |
|
|
将用于对请求签名的访问密钥 ID。此参数必须与 —秘密密钥结合使用，否则会忽略此选项。对 CloudWatch 的所有请求都必须进行签名，否则请求将被拒绝。 类型: 字符串 有效值：有效访问密钥 ID。 默认值：无 |
|
|
将用于对请求签名的私钥。使用公钥/私钥会导致 CLI 使用 SOAP。请求签名时使用公共证书和私有密钥。此参数必须与一起使用。 类型: 字符串 有效值：指向有效 ASN.1 私有密钥的路径。 默认值：无 |
|
|
区域请求被定向到。可以使用环境变量 类型: 字符串 有效值：任何Amazon区域，例如，us-east-1。 默认值：us-east-1，除非 |
|
|
将用于对请求进行签名的私有访问密钥以及访问密钥 ID。此参数必须与一起使用。 类型: 字符串 有效值：您的 访问密钥 ID。 默认值：无 |
|
|
使用 (nil) 作为占位符显示空字段，以指示未请求此数据。 类型: 标记 有效值：无 默认值：默认情况下不显示空字段。 |
|
|
显示 CLI 用于调用Amazon。 类型: 标记 有效值：无 默认值：false |
|
|
指定结果的显示方式：在表中、分隔（长）、XML 或无输出（安静）。这些区域有： 类型: 标记 有效值：无 默认值： |
|
|
用于联系 CloudWatch 的 URL。您可以使用环境变量设置此值。 类型: 字符串 有效值：有效的 HTTP 或 HTTPS URL。 默认值：使用 |
Output
此命令向指标添加指标数据点。
亚 Amazon CloudWatch CLI 在 stderr 上显示错误。
Examples
示例请求
此示例将 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"
示例请求
此示例将用户特定的 RequestCount 测试数据放在 MyService 命名空间中。用户和堆栈名称存储为维度，以便将该指标与上面的示例中的服务范围的指标区分开。
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50