InstancePatchStateFilter - Amazon Systems Manager
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Defines a filter used in DescribeInstancePatchStatesForPatchGroup to scope down the information returned by the API.

Example: To filter for all managed nodes in a patch group having more than three patches with a FailedCount status, use the following for the filter:

  • Value for Key: FailedCount

  • Value for Type: GreaterThan

  • Value for Values: 3



The key for the filter. Supported values include the following:

  • InstalledCount

  • InstalledOtherCount

  • InstalledPendingRebootCount

  • InstalledRejectedCount

  • MissingCount

  • FailedCount

  • UnreportedNotApplicableCount

  • NotApplicableCount

Type: String

Length Constraints: Minimum length of 1. Maximum length of 200.

Required: Yes


The type of comparison that should be performed for the value.

Type: String

Valid Values: Equal | NotEqual | LessThan | GreaterThan

Required: Yes


The value for the filter. Must be an integer greater than or equal to 0.

Type: Array of strings

Array Members: Fixed number of 1 item.

Required: Yes

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: