NAME
Paws::CloudWatch::PutMetricAlarm - Arguments for method PutMetricAlarm on Paws::CloudWatch
DESCRIPTION
This class represents the parameters used for calling the method PutMetricAlarm on the Amazon CloudWatch service. Use the attributes of this class as arguments to method PutMetricAlarm.
You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to PutMetricAlarm.
As an example:
$service_obj->PutMetricAlarm(Att1 => $value1, Att2 => $value2, ...);
Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object.
ATTRIBUTES
ActionsEnabled => Bool
Indicates whether or not actions should be executed during any changes to the alarm's state.
AlarmActions => ArrayRef[Str]
The list of actions to execute when this alarm transitions into an ALARM
state from any other state. Each action is specified as an Amazon Resource Name (ARN).
Valid Values: arn:aws:automate:region (e.g., us-east-1):ec2:stop | arn:aws:automate:region (e.g., us-east-1):ec2:terminate | arn:aws:automate:region (e.g., us-east-1):ec2:recover
Valid Values (for use with IAM roles): arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Stop/1.0 | arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Reboot/1.0
Note: You must create at least one stop, terminate, or reboot alarm using the Amazon EC2 or CloudWatch console to create the EC2ActionsAccess IAM role for the first time. After this IAM role is created, you can create stop, terminate, or reboot alarms using the CLI.
AlarmDescription => Str
The description for the alarm.
REQUIRED AlarmName => Str
The descriptive name for the alarm. This name must be unique within the user's AWS account
REQUIRED ComparisonOperator => Str
The arithmetic operation to use when comparing the specified Statistic
and Threshold
. The specified Statistic
value is used as the first operand.
Valid values are: "GreaterThanOrEqualToThreshold"
, "GreaterThanThreshold"
, "LessThanThreshold"
, "LessThanOrEqualToThreshold"
Dimensions => ArrayRef[Paws::CloudWatch::Dimension]
The dimensions for the alarm's associated metric.
REQUIRED EvaluationPeriods => Int
The number of periods over which data is compared to the specified threshold.
InsufficientDataActions => ArrayRef[Str]
The list of actions to execute when this alarm transitions into an INSUFFICIENT_DATA
state from any other state. Each action is specified as an Amazon Resource Name (ARN).
Valid Values: arn:aws:automate:region (e.g., us-east-1):ec2:stop | arn:aws:automate:region (e.g., us-east-1):ec2:terminate | arn:aws:automate:region (e.g., us-east-1):ec2:recover
Valid Values (for use with IAM roles): arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Stop/1.0 | arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Reboot/1.0
Note: You must create at least one stop, terminate, or reboot alarm using the Amazon EC2 or CloudWatch console to create the EC2ActionsAccess IAM role for the first time. After this IAM role is created, you can create stop, terminate, or reboot alarms using the CLI.
REQUIRED MetricName => Str
The name for the alarm's associated metric.
REQUIRED Namespace => Str
The namespace for the alarm's associated metric.
OKActions => ArrayRef[Str]
The list of actions to execute when this alarm transitions into an OK
state from any other state. Each action is specified as an Amazon Resource Name (ARN).
Valid Values: arn:aws:automate:region (e.g., us-east-1):ec2:stop | arn:aws:automate:region (e.g., us-east-1):ec2:terminate | arn:aws:automate:region (e.g., us-east-1):ec2:recover
Valid Values (for use with IAM roles): arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Stop/1.0 | arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | arn:aws:swf:us-east-1:{customer-account}:action/actions/AWS_EC2.InstanceId.Reboot/1.0
Note: You must create at least one stop, terminate, or reboot alarm using the Amazon EC2 or CloudWatch console to create the EC2ActionsAccess IAM role for the first time. After this IAM role is created, you can create stop, terminate, or reboot alarms using the CLI.
REQUIRED Period => Int
The period in seconds over which the specified statistic is applied.
REQUIRED Statistic => Str
The statistic to apply to the alarm's associated metric.
Valid values are: "SampleCount"
, "Average"
, "Sum"
, "Minimum"
, "Maximum"
REQUIRED Threshold => Num
The value against which the specified statistic is compared.
Unit => Str
The statistic's unit of measure. For example, the units for the Amazon EC2 NetworkIn metric are Bytes because NetworkIn tracks the number of bytes that an instance receives on all network interfaces. You can also specify a unit when you create a custom metric. Units help provide conceptual meaning to your data. Metric data points that specify a unit of measure, such as Percent, are aggregated separately.
Note: If you specify a unit, you must use a unit that is appropriate for the metric. Otherwise, this can cause an Amazon CloudWatch alarm to get stuck in the INSUFFICIENT DATA state.
Valid values are: "Seconds"
, "Microseconds"
, "Milliseconds"
, "Bytes"
, "Kilobytes"
, "Megabytes"
, "Gigabytes"
, "Terabytes"
, "Bits"
, "Kilobits"
, "Megabits"
, "Gigabits"
, "Terabits"
, "Percent"
, "Count"
, "Bytes/Second"
, "Kilobytes/Second"
, "Megabytes/Second"
, "Gigabytes/Second"
, "Terabytes/Second"
, "Bits/Second"
, "Kilobits/Second"
, "Megabits/Second"
, "Gigabits/Second"
, "Terabits/Second"
, "Count/Second"
, "None"
SEE ALSO
This class forms part of Paws, documenting arguments for method PutMetricAlarm in Paws::CloudWatch
BUGS and CONTRIBUTIONS
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues