CmdID / aws / aws cloudwatch
aws cloudwatch put-metric-alarm
Creates or updates an alarm and associates it with the specified metric, metric math expression, anomaly detection model, Metrics Insights query, or PromQL query. AWS CLI reference
27 options Its page in the AWS CLI reference
Options
Show its 27 options
--action-configurationSettings that change the content of the notifications and events that the alarm sends when its state changes.--actions-enabledIndicates whether actions should be executed during any changes to the alarm state.--alarm-actionsThe actions to execute when this alarm transitions to the ALARM state from any other state.--alarm-descriptionThe description for the alarm.--alarm-nameThe name for the alarm.--comparison-operatorThe arithmetic operation to use when comparing the specified statistic and threshold.--datapoints-to-alarmThe number of data points that must be breaching to trigger the alarm.--dimensionsThe dimensions for the metric specified in MetricName.--evaluate-low-sample-count-percentileUsed only for alarms based on percentiles.--evaluation-criteriaThe evaluation criteria for the alarm.--evaluation-intervalThe frequency, in seconds, at which the alarm is evaluated.--evaluation-periodsThe number of periods over which data is compared to the specified threshold.--evaluation-windowThe evaluation window that the alarm uses to select the range of metric data that it evaluates.--extended-statisticThe extended statistic for the metric specified in MetricName.--insufficient-data-actionsThe actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state.--metric-nameThe name for the metric associated with the alarm.--metricsAn array of MetricDataQuery structures that enable you to create an alarm based on the result of a metric math expression.--namespaceThe namespace for the metric associated specified in MetricName.--ok-actionsThe actions to execute when this alarm transitions to an OK state from any other state.--periodThe length, in seconds, used each time the metric specified in MetricName is evaluated.--statisticThe statistic for the metric specified in MetricName, other than percentile.--tagsA list of key-value pairs to associate with the alarm.--threshold-metric-idIf this is an alarm based on an anomaly detection model, make this value match the ID of the ANOMALY_DETECTION_BAND function.--thresholdThe value against which the specified statistic is compared.--treat-missing-dataSets how this alarm is to handle missing data points.--unitThe unit of measure for the statistic.--warm-up-configurationThe warm-up configuration for the alarm.