Filter Class | AWS SDK for .NET Version 4

A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.

If you specify multiple filters, the filters are joined with an AND, and the request returns only results that match all of the specified filters.

For more information, see List and filter using the CLI and API in the Amazon EC2 User Guide.

Inheritance Hierarchy

System.Object
Amazon.EC2.Model.Filter

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

Syntax

public class Filter

The Filter type exposes the following members

Constructors

	Name	Description
	Filter()	Empty constructor used to set properties independently even when a simple constructor is available
	Filter(string, List<String>)	Instantiates Filter with the parameterized properties
	Filter(string)	Instantiates Filter with the parameterized properties

Properties

Name Type Description

	Name	Type	Description
	Name	System.String	Gets and sets the property Name. The name of the filter. Filter names are case-sensitive.
	Values	System.Collections.Generic.List<System.String>	Gets and sets the property Values. The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an `OR`, and the request returns all results that match any of the specified values. Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Name

System.String

Gets and sets the property Name.

The name of the filter. Filter names are case-sensitive.

Values

System.Collections.Generic.List<System.String>

Gets and sets the property Values.

The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an OR, and the request returns all results that match any of the specified values.

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer