mon-put-metric-alarm

AlarmName

要更新或创建的警报的名称。名称在您的 Amazon 账户内必须是唯一的。还可以使用 --alarm-name 设置此值。

类型：参数

有效值：UTF-8 字符串。

默认值：不适用

必需：是

--actions-enabled VALUE

指示在警报状态更改时是否应执行操作。

类型：布尔值

有效值：True 或 False

默认值：True

必需：否

--alarm-actions VALUE1,VALUE2,VALUE3...

当此警报从任何其他状态转换为 ALARM 状态时，要执行的操作（最多五个）。每个操作都被指定为一个 Amazon Resource Name（ARN）。使用告警操作，您可发布到 Amazon SNS 主题，激活 Amazon EC2 Auto Scaling 策略，或停止、终止或恢复 Amazon EC2 实例。

类型：字符串

有效值：Amazon SNS 主题、Auto Scaling 策略的 ARN，或停止、终止或恢复 Amazon EC2 实例的 ARN。

默认值：不适用

必需：否

--alarm-description VALUE

警报的描述。

类型：字符串

有效值：长度介于 1 到 255 个字符之间的任何 Unicode 字符串。

默认值：不适用

必需：否

--comparison-operator VALUE

用于比较数据点与阈值的比较运算符。

类型：枚举

有效值：GreaterThanOrEqualToThreshold、GreaterThanThreshold、LessThanThreshold 或 LessThanOrEqualToThreshold 之一

默认值：不适用

必需：是

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

要为其创建警报的指标的维度。可以两种方式指定维度，且格式可结合使用或互换使用：

类型：映射

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

默认值：不适用

必需：否

--evaluation-periods VALUE

指标的值将与阈值相比较以确定警报状态的连续周期数。

类型：整数

有效值：大于零的数字。

默认值：不适用

必需：是

--metric-name VALUE

要对其报警的指标的名称。

类型：参数

有效值：长度介于 1 到 250 个字符之间的任何 ANSI 字符串。

默认值：不适用

必需：是

--namespace VALUE

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

类型：字符串

有效值：长度介于 1 到 250 个字符之间的任何 ANSI 字符串。

默认值：不适用

必需：是

--ok-actions VALUE1,VALUE2,VALUE3...

当此警报从任何其他状态转换为 OK 状态时，要执行的操作（最多五个）。每个操作都被指定为一个 Amazon Resource Name（ARN）。

类型：字符串

有效值：有效 ARN 标识符。

默认值：不适用

必需：否

--period VALUE

要对其报警的指标的时间段（以秒为单位）。

类型：参数

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

默认值：不适用

必需：是

--statistic VALUE

要对其报警的指标的统计数据。

类型：枚举

有效值：SampleCount、Average、Sum、Minimum 或 Maximum

默认值：不适用

必需：您必须指定 -statistic 或 -extendedstatistic。

--extendedstatistic VALUE

要对其报警的指标的百分位数统计数据。

类型：字符串

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

默认值：不适用

必需：您必须指定 -statistic 或 -extendedstatistic。

--threshold VALUE

数据点与其进行比较以确定警报状态的阈值。

类型：双精度

有效值：双精度值 所有值必须是介于 1E-130 和 1E130 之间的数字。

默认值：不适用

必需：是

--unit VALUE

要对其报警的指标的单位。

类型：枚举

有效值：下列值之一：

默认值：不适用

必需：否

--insufficient-data-actions VALUE1,VALUE2,VALUE3...

当此警报从任何其他状态转换为 INSUFFICIENT_DATA 状态时，要执行的操作（最多五个）。每个操作都被指定为一个 Amazon Resource Name（ARN）。

类型：字符串

有效值：有效 ARN 标识符。

默认值：不适用

必需：否

--aws-credential-file VALUE

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

类型：字符串

有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。

默认值：使用环境变量 AWS_CREDENTIAL_FILE（如果已设置）。

-C, --ec2-cert-file-path VALUE

用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 EC2_CERT 指定此值。

类型：字符串

有效值：由 Amazon EC2 或 Amazon 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，并且必须是有效的亚马逊云科技 (Amazon）区域。

类型：字符串

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

默认值：除非 EC2_REGION 环境变量已设置，否则为 us-east-1。

S, --secret-key VALUE

将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 --access-key-id 结合使用，否则此选项将被忽略。

类型：字符串

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

默认值：无

--show-empty-fields

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

类型：标记

有效值：无

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

--show-request

显示 CLI 用于调用 Amazon 的 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（如果已设置）中指定的值。