# mon-describe-alarm-history ## 说明 检索指定警报的历史记录。您可以按日期范围或项目类型筛选警报。如果不指定告警名称，Amazon CloudWatch 会返回所有告警的历史记录。 **注意** Amazon CloudWatch 将活动告警和已删除告警的历史记录保留两个星期。 ## 语法 ****mon-describe-alarm-history** [AlarmNames [{{AlarmNames}} ...]] [--end-date {{value}}] [--history-item-type {{value}}] [--start-date {{value}}] [Common Options] ** ## 选项 | 名称 | 描述 | | --- | --- | | `AlarmName` `AlarmNames` | 警报的名称，用空格分隔。如果不指定警报名称，此命令会返回所有警报的历史记录。还可以使用 `--alarm-name` 设置此值。
类型：参数
有效值：长度介于 1 到 255 个字符之间的任何字符串。
默认值：不适用
必需：否 | | `--end-date` `VALUE` | 历史记录的日期范围的结束日期。
类型：日期
有效值：YYYY-MM-DD 格式的日期。
默认值：当前日期。
必需：否 | | `--history-item-type` `VALUE` | 要检索的历史记录项的类型。默认情况下，返回所有类型。
类型：枚举
有效值：ConfigurationUpdate、StateUpdate 或 Action
默认值：返回所有类型。
必需：否 | | `--start-date` `VALUE` | 历史记录的日期范围的开始日期。默认情况下，它会延伸到所有可用历史记录。
类型：日期
有效值：YYYY-MM-DD 格式的日期。
默认值：所有可用历史记录。
必需：否 | ## 常用选项 | 名称 | 描述 | | --- | --- | | `--aws-credential-file` `VALUE` | 带有 AWS 凭证的文件的位置。您可以使用环境变量 `AWS_CREDENTIAL_FILE` 设置此值。如果您定义了环境变量或提供了凭证文件的路径，则该文件必须存在，否则请求将失败。必须使用访问密钥 ID 和秘密访问密钥签署所有 CloudWatch 请求。
类型：字符串
有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。
默认值：使用环境变量 `AWS_CREDENTIAL_FILE`（如果已设置）。 | | `-C, --ec2-cert-file-path` `VALUE` | 用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 `EC2_CERT` 指定此值。
类型：字符串
有效值：由 Amazon EC2 或 AWS 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，并且必须是有效的亚马逊云科技 (AWS）区域。
类型：字符串
有效值：任意 AWS 区域，例如 us-east-1。
默认值：除非 `EC2_REGION` 环境变量已设置，否则为 us-east-1。 | | `S, --secret-key` `VALUE` | 将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 `--access-key-id` 结合使用，否则此选项将被忽略。
类型：字符串
有效值：您的访问密钥 ID。
默认值：无 | | `--show-empty-fields` `` | 使用 (nil) 作为占位符显示空字段，以指示未请求此数据。
类型：标记
有效值：无
默认值：默认情况下不显示空字段。 | | `--show-request` `` | 显示 CLI 用于调用 AWS 的 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 此命令将返回包含以下内容的表格： + ALARM - 警报名称。 + TIMESTAMP - 时间戳。 + TYPE - 事件类型，ConfigurationUpdate、StateUpdate 和 Action 之一。 + SUMMARY - 历史记录事件的人可读汇总。 + DATA - 有关事件的机器可读 JSON 格式的详细数据。该列仅在 --show-long 视图中显示。 Amazon CloudWatch CLI 在 stderr 上显示错误。 ## 示例 ### 示例请求 此示例描述 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 ``` ## 相关主题 ### 下载 + [设置命令行界面](SetupCLI.md) ### 相关操作 + [DescribeAlarmHistory](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html) ### 相关命令 + [mon-describe-alarms](cli-mon-describe-alarms.md) + [mon-describe-alarms-for-metric](cli-mon-describe-alarms-for-metric.md)