Temporarily sets the state of an alarm for testing purposes. When the updated state differs from the previous value, the action configured for the appropriate state is invoked. For example, if your alarm is configured to send an Amazon SNS message when an alarm is triggered, temporarily changing the alarm state to ALARM sends an SNS message.
See https://www.paws-r-sdk.com/docs/cloudwatch_set_alarm_state/ for full documentation.
cloudwatch_set_alarm_state(
AlarmName,
StateValue,
StateReason,
StateReasonData = NULL
)[required] The name of the alarm.
[required] The value of the state.
[required] The reason that this alarm is set to this specific state, in text format.
The reason that this alarm is set to this specific state, in JSON format.
For SNS or EC2 alarm actions, this is just informational. But for EC2 Auto Scaling or application Auto Scaling alarm actions, the Auto Scaling policy uses the information in this field to take the correct action.