mon-describe-alarms-for-metric

--dimensions - "key1=value1,key2=value2...

与指标关联的维度。可以两种方式指定维度，且格式可结合使用或互换使用：

类型: 映射

有效值：格式为 name=value 的字符串，其中，键是维度的名称，值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。

默认值：不适用

：必需 否

--metric-name VALUE

要搜索其关联警报的指标的名称。

类型: 参数

有效值：长度介于 1 到 255 个字符之间的有效指标名称。

默认值：不适用

：必需 是

--namespace VALUE

与警报关联的指标的命名空间。有关命名空间的更多信息，请参阅 Amazon 命名空间。

类型: 字符串

有效值：长度介于 1 到 250 个字符之间的有效命名空间。

默认值：不适用

：必需 是

--period VALUE

按其筛选警报的时间段。 结果中仅包含评估此周期的指标的警报。如果未指定，则会包含所有周期的警报。

类型: 参数

有效值：以秒为单位的数字，是 60 秒的倍数。

默认值：不适用

：必需 否

--statistic VALUE

按其筛选警报的统计数据。 仅包含指定统计数据的警报。 如果未指定此参数，则会包含所有统计数据的警报。

类型: 枚举

有效值：SampCount、A、Sum、Max或 Max

默认值：不适用

：必需 否

--extendedstatistic VALUE

按其筛选警报的百分位数统计数据。 仅包含指定统计数据的警报。 如果未指定此参数，则会包含所有统计数据的警报。

类型: 字符串

有效值：最多两个小数位的任何百分位数 (例如 p95.45)。

默认值：不适用

：必需 否

--unit VALUE

按其筛选警报的单位。仅包含指定统计数据的警报。如果未指定，则会包含所有单位的警报。如果没有为警报指定单位，则搜索警报的唯一方式是忽略此选项。

类型: 枚举

有效值：下列情况之一：

默认值：不适用

：必需 否

--aws-credential-file VALUE

文件的位置，Amazon凭证。您可以使用环境变量设置此值。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 (Amazon）区域。

类型: 字符串

有效值：任何Amazon区域，例如，us-east-1。

默认值：us-east-1，除非EC2_REGION环境变量。

S, --secret-key VALUE

将用于对请求进行签名的私有访问密钥以及访问密钥 ID。此参数必须与一起使用。--access-key-id，否则将忽略此选项。

类型: 字符串

有效值：您的 访问密钥 ID。

默认值：无

--show-empty-fields

使用 (nil) 作为占位符显示空字段，以指示未请求此数据。

类型: 标记

有效值：无

默认值：默认情况下不显示空字段。

--show-request

显示 CLI 用于调用Amazon。

类型: 标记

有效值：无

默认值：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（如果已设置）。