DescribeAlarmsForMetricRequest Class

Container for the parameters to the DescribeAlarmsForMetric operation. Retrieves the alarms for the specified metric. To filter the results, specify a statistic, period, or unit.

This operation retrieves only standard alarms that are based on the specified metric. It does not return alarms based on math expressions that use the specified metric, or composite alarms that use the specified metric.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.CloudWatch.AmazonCloudWatchRequest
      Amazon.CloudWatch.Model.DescribeAlarmsForMetricRequest

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

Syntax

public class DescribeAlarmsForMetricRequest : AmazonCloudWatchRequest
         IAmazonWebServiceRequest

The DescribeAlarmsForMetricRequest type exposes the following members

Constructors

	Name	Description
	DescribeAlarmsForMetricRequest()

Properties

Name	Type	Description
Dimensions	System.Collections.Generic.List<Amazon.CloudWatch.Model.Dimension>	Gets and sets the property Dimensions. The dimensions associated with the metric. If the metric has any associated dimensions, you must specify them in order for the call to succeed.
ExtendedStatistic	System.String	Gets and sets the property ExtendedStatistic. The percentile statistic for the metric. Specify a value between p0.0 and p100.
MetricName	System.String	Gets and sets the property MetricName. The name of the metric.
Namespace	System.String	Gets and sets the property Namespace. The namespace of the metric.
Period	System.Int32	Gets and sets the property Period. The period, in seconds, over which the statistic is applied.
Statistic	Amazon.CloudWatch.Statistic	Gets and sets the property Statistic. The statistic for the metric, other than percentiles. For percentile statistics, use `ExtendedStatistics`.
Unit	Amazon.CloudWatch.StandardUnit	Gets and sets the property Unit. The unit for the metric.

Examples

This example shows how to get information about all alarms for a metric.

Get metric alarms example

var client = new AmazonCloudWatchClient();

var dimension = new Dimension
{
  Name = "AutoScalingGroupName",
  Value = "awseb-e-kkbEXAMPLE-stack-AutoScalingGroup-F4TAUEXAMPLE"
};

var request = new DescribeAlarmsForMetricRequest
{
  Dimensions = new List<Dimension>() { dimension },
  MetricName = "NetworkOut",
  Namespace = "AWS/EC2"
};

var response = client.DescribeAlarmsForMetric(request);

if (response.MetricAlarms.Count > 0)
{
  foreach (var alarm in response.MetricAlarms)
  {
    Console.WriteLine();
    Console.WriteLine(alarm.AlarmName);
    Console.WriteLine(alarm.AlarmDescription);
    Console.WriteLine(alarm.MetricName + " " +
      alarm.ComparisonOperator + " " + alarm.Threshold);
  }
}
else
{
  Console.WriteLine("No alarms.");
}

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