mon-describe-alarms - Amazon CloudWatch
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

mon-describe-alarms

Description

获取有关指定警报的信息。如果不指定警报名称,此命令会返回有关所有警报的信息。只能使用警报名称前缀、警报状态或操作前缀检索警报。

Syntax

mon-describe-alarms [AlarmNames [AlarmNames ...]] [--action-prefix value] [--alarm-name-prefix value] [--state-value value] [Common Options]

Options

名称 描述

AlarmNames AlarmNames

警报的名称。还可以使用 --alarm-name 设置此值。您可以多次指定该选项。

类型: 参数

有效值:现有警报名称,否则不会返回任何响应。

默认值:不适用,默认情况下显示所有警报。

:必需 否

--action-prefix VALUE

操作名称的前缀。

类型: 参数

有效值:现有操作名称的前缀,采用 ARN 格式。

默认值:不适用,默认情况下显示第一个操作。

:必需 否

--alarm-name-prefix VALUE

警报名称的前缀。

类型: 参数

有效值:现有警报名称的前缀。

默认值:不适用

:必需 否

--state-value VALUE

警报的状态。

类型: 枚举

有效值:正常、警报或数据不足

默认值:所有警报状态。

:必需 否

常用选项

名称 描述

--aws-credential-file VALUE

带有 AWS 凭证的文件的位置。您可以使用环境变量设置此值。AWS_CREDENTIAL_FILE。如果您定义了环境变量或提供了凭据文件的路径,则该文件必须存在,否则请求将失败。所有 CloudWatch 请求必须使用访问密钥 ID 和秘密访问密钥来签名。

类型: 字符串

有效值:包含访问密钥 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选项默认情况下,该选项为 off。

-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 Web Services (AWS) 区域。

类型: 字符串

有效值:任何 AWS 区域,例如 us-east-1。

默认值:us-east-1,除非EC2_REGION环境变量。

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

此命令将返回包含以下内容的表格:

  • 警报-警报名称。

  • 描述-警报描述。该列仅在 --show-long 视图中显示。

  • 状态-警报状态。

  • 状态 _ 原因-状态的人可读原因。该列仅在 --show-long 视图中显示。

  • 状态原理数据-状态的机器可读原因(JSON 格式)。该列仅在 --show-long 视图中显示。

  • 启用-启用或禁用操作。该列仅在 --show-long 视图中显示。

  • OK_操作-要在 “正常” 状态下执行的操作。该列仅在 --show-long 视图中显示。

  • 警报操作-在警报状态下执行的操作。

  • 不足数据操作-要在数据不足状态下执行的操作。该列仅在 --show-long 视图中显示。

  • 命名空间 — 指标的命名空间。

  • 指标名称 — 指标的名称。

  • 维度-指标维度。该列仅在 --show-long 视图中显示。

  • 期间-期间。

  • 统计数据-统计数据(平均值、最小值、最大值、总计和 SampleCount 值)。

  • 扩展统计数据-百分位数统计数据。

  • 单位-单位。该列仅在 --show-long 视图中显示。

  • EVAL_EVAL_PRESE-用于评估度量的期间数。

  • 比较 — 比较运算符。

  • 阈值-阈值。

亚 Amazon CloudWatch CLI 在 stderr 上显示错误。

Examples

示例请求

此示例描述其名称以 my-alarm 开头的所有警报。

mon-describe-alarms --alarm-name-prefix my-alarm --headers

以下是该命令的示例输出。

ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0 my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80o.0

相关主题

Download

相关操作

相关命令