本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
mon-describe-alarm-history
Description
检索指定警报的历史记录。您可以按日期范围或项目类型筛选警报。如果不指定警报名称,Amazon CloudWatch 会返回所有警报的历史记录。
Amazon CloudWatch 将活动警报和已删除警报的历史记录保存两个星期。
Syntax
mon-describe-alarm-history
[AlarmNames [
AlarmNames
...]] [--end-date value
] [--history-item-type value
]
[--start-date value
] [Common Options]
Options
名称 | 描述 |
---|---|
|
警报的名称,用空格分隔。如果不指定警报名称,此命令会返回所有警报的历史记录。还可以使用 类型: 参数 有效值:长度介于 1 到 255 个字符之间的任何字符串。 默认值:不适用 必需:否 |
|
历史记录的日期范围的结束日期。 类型: 日期 有效值:YYYY-MM-DD 格式的日期。 默认值:当前日期。 必需:否 |
|
要检索的历史记录项的类型。默认情况下,返回所有类型。 类型: 枚举 有效值:ConfigurationUpdate、StateUpdate 或操作 默认值:将返回所有类型。 必需:否 |
|
历史记录的日期范围的开始日期。默认情况下,它会延伸到所有可用历史记录。 类型: 日期 有效值:YYYY-MM-DD 格式的日期。 默认值:所有可用历史记录。 必需:否 |
常用选项
名称 | 说明 |
---|---|
|
带有 AWS 凭证的文件位置。您可以使用 类型:字符串 有效值:包含访问密钥 ID 和秘密访问密钥的文件的有效路径。 默认:使用 |
|
用于对请求进行签名的 EC2 证书文件的位置。您可以使用环境变量 类型:字符串 有效值:Amazon EC2 或 AWS Identity and Access Management 提供的 PEM 文件的有效文件路径。 默认:使用 |
|
连接超时值(按秒计)。 类型:整数 有效值:任意正数。 默认值:30 |
|
显示带分隔符(长整型)结果时使用的分隔符。 类型:字符串 有效值:任意字符串。 默认值:逗号 (,) |
|
如果您正在显示表格式或带分隔符的结果,则包括列标题。如果您正在显示 XML 结果,则通过服务请求返回 HTTP 标头(如适用)。 类型:标志 有效值:存在时显示标头。 默认值: |
|
将与秘密密钥结合使用对请求进行签名的访问密钥 ID。它必须与 --secret-key 结合使用,否则将忽略该选项。必须对所有 CloudWatch 请求进行签名,否则请求将被拒绝。 类型:字符串 有效值:有效的访问密钥 ID。 默认值:无 |
|
将用于对请求进行签名的私钥。使用公钥/私钥会导致 CLI 使用 SOAP。使用公共证书和私钥对请求进行签名。此参数必须与 类型:字符串 有效值:有效 ASN.1 私钥的路径。 默认值:无 |
|
请求被定向到的区域。您可以使用环境变量 类型:字符串 有效值:任何 AWS 区域,例如 us-east-1。 默认:us-east-1,除非已设置 |
|
将与访问密钥 ID 结合使用来对请求进行签名的秘密访问密钥。此参数必须与 类型:字符串 有效值:访问密钥 ID。 默认值:无 |
|
使用 (nil) 作为占位符显示空字段,以指示未请求此数据。 类型:标志 有效值:无 默认值:默认情况下不显示空字段。 |
|
显示 CLI 用于调用 AWS 的 URL。 类型:标志 有效值:无 默认值:false |
|
指定显示结果的方式:表格、带分隔符(长整型)、XML 或无输出(秘密型)。 类型:标志 有效值:无 默认值: |
|
用于联系 CloudWatch 的 URL。您可以使用 类型:字符串 有效值:有效的 HTTP 或 HTTPS URL。 默认值:使用 |
Output
此命令将返回包含以下内容的表格:
-
ALARM - 警报名称。
-
TIMESTAMP - 时间戳。
-
TYPE - 事件类型,为 ConfigurationUpdate、StateUpdate 和 Action 之一。
-
SUMMARY - 历史记录事件的人可读汇总。
-
DATA - 有关事件的机器可读 JSON 格式的详细数据。该列仅在 --show-long 视图中显示。
Amazon CloudWatch CLI 在 stderr 上显示错误。
Examples
示例请求
此示例描述 my-alarm 警报的所有历史记录项。
mon-describe-alarm-history--alarm-name my-alarm --headers
以下是该命令的示例输出。
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