# Filter
<a name="API_Filter"></a>

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

## Contents
<a name="API_Filter_Contents"></a>

 ** name **   <a name="imagebuilder-Type-Filter-name"></a>
The name of the filter. Filter names are case-sensitive.  
Type: String  
Pattern: `^[a-zA-Z]{1,1024}$`   
Required: No

 ** values **   <a name="imagebuilder-Type-Filter-values"></a>
The filter values. Filter values are case-sensitive.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Pattern: `^[0-9a-zA-Z./_ :,{}"-]{1,1024}$`   
Required: No

## See Also
<a name="API_Filter_SeeAlso"></a>

For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/imagebuilder-2019-12-02/Filter) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/imagebuilder-2019-12-02/Filter) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/imagebuilder-2019-12-02/Filter)