LifecyclePolicyDetailFilter - EC2 Image Builder
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).

LifecyclePolicyDetailFilter

Defines filters that the lifecycle policy uses to determine impacted resource.

Contents

type

Filter resources based on either age or count.

Type: String

Valid Values: AGE | COUNT

Required: Yes

value

The number of units for the time period or for the count. For example, a value of 6 might refer to six months or six AMIs.

Note

For count-based filters, this value represents the minimum number of resources to keep on hand. If you have fewer resources than this number, the resource is excluded from lifecycle actions.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 1000.

Required: Yes

retainAtLeast

For age-based filters, this is the number of resources to keep on hand after the lifecycle DELETE action is applied. Impacted resources are only deleted if you have more than this number of resources. If you have fewer resources than this number, the impacted resource is not deleted.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 10.

Required: No

unit

Defines the unit of time that the lifecycle policy uses to determine impacted resources. This is required for age-based rules.

Type: String

Valid Values: DAYS | WEEKS | MONTHS | YEARS

Required: No

See Also

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