Package software.amazon.awscdk.services.imagebuilder.alpha

Class LifecyclePolicy

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.Resource
software.amazon.awscdk.services.imagebuilder.alpha.LifecyclePolicy
All Implemented Interfaces:
IEnvironmentAware, IResource, ILifecyclePolicy, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)", date="2025-12-05T22:26:50.071Z") @Stability(Experimental) public class LifecyclePolicy extends Resource implements ILifecyclePolicy
(experimental) Represents an EC2 Image Builder Lifecycle Policy.

Example: 

 LifecyclePolicy disabledPolicy = LifecyclePolicy.Builder.create(this, "DisabledPolicy")
         .lifecyclePolicyName("my-disabled-policy")
         .description("A lifecycle policy that is temporarily disabled")
         .status(LifecyclePolicyStatus.DISABLED)
         .resourceType(LifecyclePolicyResourceType.AMI_IMAGE)
         .details(List.of(LifecyclePolicyDetail.builder()
                 .action(LifecyclePolicyAction.builder().type(LifecyclePolicyActionType.DELETE).build())
                 .filter(LifecyclePolicyFilter.builder().ageFilter(LifecyclePolicyAgeFilter.builder().age(Duration.days(30)).build()).build())
                 .build()))
         .resourceSelection(LifecyclePolicyResourceSelection.builder()
                 .tags(Map.of("Environment", "testing"))
                 .build())
         .tags(Map.of(
                 "Owner", "DevOps",
                 "CostCenter", "Engineering"))
         .build();

See Also:

  • Field Details

    • PROPERTY_INJECTION_ID

      @Stability(Experimental) public static final String PROPERTY_INJECTION_ID
      (experimental) Uniquely identifies this class.

  • Constructor Details

    • LifecyclePolicy

      protected LifecyclePolicy(software.amazon.jsii.JsiiObjectRef objRef)

    • LifecyclePolicy

      protected LifecyclePolicy(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • LifecyclePolicy

      @Stability(Experimental) public LifecyclePolicy(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull LifecyclePolicyProps props)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props - This parameter is required.

  • Method Details

    • fromLifecyclePolicyArn

      @Stability(Experimental) @NotNull public static ILifecyclePolicy fromLifecyclePolicyArn(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull String lifecyclePolicyArn)
      (experimental) Import an existing lifecycle policy given its ARN.

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      lifecyclePolicyArn - This parameter is required.

    • fromLifecyclePolicyName

      @Stability(Experimental) @NotNull public static ILifecyclePolicy fromLifecyclePolicyName(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull String lifecyclePolicyName)
      (experimental) Import an existing lifecycle policy given its name.

      If the name is a token representing a dynamic CloudFormation expression, you must ensure all alphabetic characters in the expression are already lowercased

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      lifecyclePolicyName - This parameter is required.

    • isLifecyclePolicy

      @Stability(Experimental) @NotNull public static Boolean isLifecyclePolicy(@NotNull Object x)
      (experimental) Return whether the given object is a LifecyclePolicy.

      Parameters:
      x - This parameter is required.

    • grant

      @Stability(Experimental) @NotNull public Grant grant(@NotNull IGrantable grantee, @NotNull String... actions)
      (experimental) Grant custom actions to the given grantee for the lifecycle policy.

      Specified by:
      grant in interface ILifecyclePolicy
      Parameters:
      grantee - This parameter is required.
      actions - This parameter is required.

    • grantRead

      @Stability(Experimental) @NotNull public Grant grantRead(@NotNull IGrantable grantee)
      (experimental) Grant read permissions to the given grantee for the lifecycle policy.

      Specified by:
      grantRead in interface ILifecyclePolicy
      Parameters:
      grantee - This parameter is required.

    • getExecutionRole

      @Stability(Experimental) @NotNull public IRole getExecutionRole()
      (experimental) The execution role used for lifecycle policy executions.

    • getLifecyclePolicyArn

      @Stability(Experimental) @NotNull public String getLifecyclePolicyArn()
      (experimental) The ARN of the lifecycle policy.
      Specified by:
      getLifecyclePolicyArn in interface ILifecyclePolicy

    • getLifecyclePolicyName

      @Stability(Experimental) @NotNull public String getLifecyclePolicyName()
      (experimental) The name of the lifecycle policy.
      Specified by:
      getLifecyclePolicyName in interface ILifecyclePolicy