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.

Represents filters for a dimension.

Inheritance Hierarchy


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


public class DimensionFilter

The DimensionFilter type exposes the following members


Public Method DimensionFilter()


Public Property Name System.String

Gets and sets the property Name.

The dimension name to be matched.

Public Property Value System.String

Gets and sets the property Value.

The value of the dimension to be matched.


This example shows how to list a set of metrics.

List metrics example

var client = new AmazonCloudWatchClient();

var filter = new DimensionFilter
  Name = "InstanceType",
  Value = "t1.micro"

var request = new ListMetricsRequest
  Dimensions = new List() { filter },
  MetricName = "CPUUtilization",
  Namespace = "AWS/EC2"

var response = new ListMetricsResponse();

  response = client.ListMetrics(request);

  if (response.Metrics.Count > 0)
    foreach (var metric in response.Metrics)
      Console.WriteLine(metric.MetricName +
        " (" + metric.Namespace + ")");

      foreach (var dimension in metric.Dimensions)
        Console.WriteLine("  " + dimension.Name + ": "
          + dimension.Value);
    Console.WriteLine("No metrics found.");

  request.NextToken = response.NextToken;

} while (!string.IsNullOrEmpty(response.NextToken));

Version Information

.NET Standard:
Supported in: 1.3

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms