# DescribeImagesFilter
<a name="API_DescribeImagesFilter"></a>

An object representing a filter on a [DescribeImages](API_DescribeImages.md) operation.

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

 ** imageStatus **   <a name="ECR-Type-DescribeImagesFilter-imageStatus"></a>
The image status with which to filter your [DescribeImages](API_DescribeImages.md) results. Valid values are `ACTIVE`, `ARCHIVED`, and `ACTIVATING`. If not specified, only images with `ACTIVE` status are returned.  
Type: String  
Valid Values: `ACTIVE | ARCHIVED | ACTIVATING | ANY`   
Required: No

 ** tagStatus **   <a name="ECR-Type-DescribeImagesFilter-tagStatus"></a>
The tag status with which to filter your [DescribeImages](API_DescribeImages.md) results. You can filter results based on whether they are `TAGGED` or `UNTAGGED`.  
Type: String  
Valid Values: `TAGGED | UNTAGGED | ANY`   
Required: No

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

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/ecr-2015-09-21/DescribeImagesFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/ecr-2015-09-21/DescribeImagesFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/ecr-2015-09-21/DescribeImagesFilter)