> **Experimental**
>
> `@aws-cdk/aws-imagebuilder-alpha` is an [**experimental**](https://docs.aws.amazon.com/cdk/api/stability.html) (alpha) package: its API may change in any release, without a major version bump.
# LifecyclePolicyProps

Properties for creating a Lifecycle Policy resource.

Used as props by: [LifecyclePolicy](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.LifecyclePolicy.html)

- Stability: [Experimental](https://docs.aws.amazon.com/cdk/api/stability.html)
- Source: [`lib/lifecycle-policy.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/aws-imagebuilder-alpha/lib/lifecycle-policy.ts#L286)

## Example

TypeScript:

```ts
const disabledPolicy = new imagebuilder.LifecyclePolicy(this, 'DisabledPolicy', {
  lifecyclePolicyName: 'my-disabled-policy',
  description: 'A lifecycle policy that is temporarily disabled',
  status: imagebuilder.LifecyclePolicyStatus.DISABLED,
  resourceType: imagebuilder.LifecyclePolicyResourceType.AMI_IMAGE,
  details: [
    {
      action: { type: imagebuilder.LifecyclePolicyActionType.DELETE },
      filter: { ageFilter: { age: Duration.days(30) } }
    }
  ],
  resourceSelection: {
    tags: { Environment: 'testing' }
  },
  tags: {
    Owner: 'DevOps',
    CostCenter: 'Engineering'
  }
});
```

Python:

```python
disabled_policy = imagebuilder.LifecyclePolicy(self, "DisabledPolicy",
    lifecycle_policy_name="my-disabled-policy",
    description="A lifecycle policy that is temporarily disabled",
    status=imagebuilder.LifecyclePolicyStatus.DISABLED,
    resource_type=imagebuilder.LifecyclePolicyResourceType.AMI_IMAGE,
    details=[imagebuilder.LifecyclePolicyDetail(
        action=imagebuilder.LifecyclePolicyAction(type=imagebuilder.LifecyclePolicyActionType.DELETE),
        filter=imagebuilder.LifecyclePolicyFilter(age_filter=imagebuilder.LifecyclePolicyAgeFilter(age=Duration.days(30)))
    )
    ],
    resource_selection=imagebuilder.LifecyclePolicyResourceSelection(
        tags={"Environment": "testing"}
    ),
    tags={
        "Owner": "DevOps",
        "CostCenter": "Engineering"
    }
)
```

Java:

```java
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();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.ImageBuilder.Alpha
var disabledPolicy = new LifecyclePolicy(this, "DisabledPolicy", new LifecyclePolicyProps {
    LifecyclePolicyName = "my-disabled-policy",
    Description = "A lifecycle policy that is temporarily disabled",
    Status = LifecyclePolicyStatus.DISABLED,
    ResourceType = LifecyclePolicyResourceType.AMI_IMAGE,
    Details = new [] { new LifecyclePolicyDetail {
        Action = new LifecyclePolicyAction { Type = LifecyclePolicyActionType.DELETE },
        Filter = new LifecyclePolicyFilter { AgeFilter = new LifecyclePolicyAgeFilter { Age = Duration.Days(30) } }
    } },
    ResourceSelection = new LifecyclePolicyResourceSelection {
        Tags = new Dictionary<string, string> { { "Environment", "testing" } }
    },
    Tags = new Dictionary<string, string> {
        { "Owner", "DevOps" },
        { "CostCenter", "Engineering" }
    }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awsimagebuilderalpha/v2
disabledPolicy := imagebuilder.NewLifecyclePolicy(this, jsii.String("DisabledPolicy"), &LifecyclePolicyProps{
	LifecyclePolicyName: jsii.String("my-disabled-policy"),
	Description: jsii.String("A lifecycle policy that is temporarily disabled"),
	Status: imagebuilder.LifecyclePolicyStatus_DISABLED,
	ResourceType: imagebuilder.LifecyclePolicyResourceType_AMI_IMAGE,
	Details: []LifecyclePolicyDetail{
		&LifecyclePolicyDetail{
			Action: &LifecyclePolicyAction{
				Type: imagebuilder.LifecyclePolicyActionType_DELETE,
			},
			Filter: &LifecyclePolicyFilter{
				AgeFilter: &LifecyclePolicyAgeFilter{
					Age: awscdk.Duration_Days(jsii.Number(30)),
				},
			},
		},
	},
	ResourceSelection: &LifecyclePolicyResourceSelection{
		Tags: map[string]*string{
			"Environment": jsii.String("testing"),
		},
	},
	Tags: map[string]*string{
		"Owner": jsii.String("DevOps"),
		"CostCenter": jsii.String("Engineering"),
	},
})
```

## Properties

- `description`: string = None — The description of the lifecycle policy.

- `details`: [LifecyclePolicyDetail](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.LifecyclePolicyDetail.html)[] (required) — Configuration details for the lifecycle policy rules.

- `executionRole`: [IRole](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_iam.IRole.html) — The execution role that grants Image Builder access to run lifecycle actions.

  **Default:** an execution role will be generated

  By default, an execution role will be created with the minimal permissions needed to execute the lifecycle policy
  actions.

- `lifecyclePolicyName`: string — The name of the lifecycle policy.

  **Default:** a name is generated

- `resourceSelection`: [LifecyclePolicyResourceSelection](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.LifecyclePolicyResourceSelection.html) (required) — Selection criteria for the resources that the lifecycle policy applies to.

- `resourceType`: [LifecyclePolicyResourceType](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.LifecyclePolicyResourceType.html) (required) — The type of Image Builder resource that the lifecycle policy applies to.

- `status`: [LifecyclePolicyStatus](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.LifecyclePolicyStatus.html) = LifecyclePolicyStatus.ENABLED — The status of the lifecycle policy.

- `tags`: { [key: string]: string } = none — The tags to apply to the lifecycle policy.
