AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Describes an alarm.

An alarm is a way to monitor your Lightsail resource metrics. For more information, see Alarms in Amazon Lightsail.

Inheritance Hierarchy

System.Object
  Amazon.Lightsail.Model.Alarm

Namespace: Amazon.Lightsail.Model
Assembly: AWSSDK.Lightsail.dll
Version: 3.x.y.z

Syntax

C#
public class Alarm

The Alarm type exposes the following members

Constructors

NameDescription
Public Method Alarm()

Properties

NameTypeDescription
Public Property Arn System.String

Gets and sets the property Arn.

The Amazon Resource Name (ARN) of the alarm.

Public Property ComparisonOperator Amazon.Lightsail.ComparisonOperator

Gets and sets the property ComparisonOperator.

The arithmetic operation used when comparing the specified statistic and threshold.

Public Property ContactProtocols System.Collections.Generic.List<System.String>

Gets and sets the property ContactProtocols.

The contact protocols for the alarm, such as Email, SMS (text messaging), or both.

Public Property CreatedAt System.DateTime

Gets and sets the property CreatedAt.

The timestamp when the alarm was created.

Public Property DatapointsToAlarm System.Int32

Gets and sets the property DatapointsToAlarm.

The number of data points that must not within the specified threshold to trigger the alarm.

Public Property EvaluationPeriods System.Int32

Gets and sets the property EvaluationPeriods.

The number of periods over which data is compared to the specified threshold.

Public Property Location Amazon.Lightsail.Model.ResourceLocation

Gets and sets the property Location.

An object that lists information about the location of the alarm.

Public Property MetricName Amazon.Lightsail.MetricName

Gets and sets the property MetricName.

The name of the metric associated with the alarm.

Public Property MonitoredResourceInfo Amazon.Lightsail.Model.MonitoredResourceInfo

Gets and sets the property MonitoredResourceInfo.

An object that lists information about the resource monitored by the alarm.

Public Property Name System.String

Gets and sets the property Name.

The name of the alarm.

Public Property NotificationEnabled System.Boolean

Gets and sets the property NotificationEnabled.

Indicates whether the alarm is enabled.

Public Property NotificationTriggers System.Collections.Generic.List<System.String>

Gets and sets the property NotificationTriggers.

The alarm states that trigger a notification.

Public Property Period System.Int32

Gets and sets the property Period.

The period, in seconds, over which the statistic is applied.

Public Property ResourceType Amazon.Lightsail.ResourceType

Gets and sets the property ResourceType.

The Lightsail resource type of the alarm.

Public Property State Amazon.Lightsail.AlarmState

Gets and sets the property State.

The current state of the alarm.

An alarm has the following possible states:

  • ALARM - The metric is outside of the defined threshold.

  • INSUFFICIENT_DATA - The alarm has just started, the metric is not available, or not enough data is available for the metric to determine the alarm state.

  • OK - The metric is within the defined threshold.

Public Property Statistic Amazon.Lightsail.MetricStatistic

Gets and sets the property Statistic.

The statistic for the metric associated with the alarm.

The following statistics are available:

  • Minimum - The lowest value observed during the specified period. Use this value to determine low volumes of activity for your application.

  • Maximum - The highest value observed during the specified period. Use this value to determine high volumes of activity for your application.

  • Sum - All values submitted for the matching metric added together. You can use this statistic to determine the total volume of a metric.

  • Average - The value of Sum / SampleCount during the specified period. By comparing this statistic with the Minimum and Maximum values, you can determine the full scope of a metric and how close the average use is to the Minimum and Maximum values. This comparison helps you to know when to increase or decrease your resources.

  • SampleCount - The count, or number, of data points used for the statistical calculation.

Public Property SupportCode System.String

Gets and sets the property SupportCode.

The support code. Include this code in your email to support when you have questions about your Lightsail alarm. This code enables our support team to look up your Lightsail information more easily.

Public Property Threshold System.Double

Gets and sets the property Threshold.

The value against which the specified statistic is compared.

Public Property TreatMissingData Amazon.Lightsail.TreatMissingData

Gets and sets the property TreatMissingData.

Specifies how the alarm handles missing data points.

An alarm can treat missing data in the following ways:

  • breaching - Assume the missing data is not within the threshold. Missing data counts towards the number of times the metric is not within the threshold.

  • notBreaching - Assume the missing data is within the threshold. Missing data does not count towards the number of times the metric is not within the threshold.

  • ignore - Ignore the missing data. Maintains the current alarm state.

  • missing - Missing data is treated as missing.

Public Property Unit Amazon.Lightsail.MetricUnit

Gets and sets the property Unit.

The unit of the metric associated with the alarm.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5, 4.0, 3.5