View lifecycle policy details - EC2 Image Builder

View lifecycle policy details

The lifecycle policy detail page in the Image Builder console includes a summary section, with additional information grouped into tabs. The page heading is the name of the policy.

On the lifecycle policy details page in the Image Builder console, you can view details for a specific lifecycle policy. You can also use commands or actions with the Image Builder API, SDKs, or AWS CLI to get policy details.

View lifecycle policy details in the Image Builder console

The image detail page in the Image Builder console includes a summary section, with additional information grouped into tabs. The page heading is the name and build version of the recipe that created the image.

Console detail sections and tabs

Summary section

The summary section spans the width of the page and includes the following details. These details are always displayed.

Policy status

Whether the policy is active or inactive.

Type

The type of output image that Image Builder distributes when you create a new image version (AMI or container image).

Date created

The timestamp from the creation of the lifecycle policy.

Date modified

The last time the lifecycle policy was updated.

Last run date

The last time the lifecycle policy ran.

IAM role

The IAM role that Image Builder uses to perform lifecycle actions.

ARN

The Amazon Resource Name (ARN) of the lifecycle policy resource.

Description

The description for the lifecycle policy, if entered.

Rules tab

The Rules tab displays the lifecycle rules that you configured for the policy you're viewing. The tab includes the following details:

  • Name – The name of the rule. These names are static, based on policy actions you can configure.

    • Deprecation rule

    • Disable rule

    • Deletion rule

  • Rule – A short description of the action that's configured for the rule.

  • Rule conditions – Lists configuration for associated resource handling, exceptions to the rule, and retention settings, if applicable.

For more information about rule configuration, see How lifecycle rules work.

Scope tab

The Scope tab displays the resource selection criteria that are configured for the policy you're viewing. The tab includes the following details:

  • Filter: type of filter – The filter type you used to define the scope. The filter type can be one of the following:

    • recipes – The recipes that were used to create the images that the lifecycle policy applies to.

    • tags – A set of tags that Image Builder uses to select image resources that the lifecycle policy applies to.

  • A search bar – You can filter the list by Name to streamline results that display in the tab.

  • Name – Each row contains a name or tag that you've configured for the filter criteria.

  • Version – If you've configured a recipe filter, Image Builder displays the recipe version.

RunLog tab

Each time you run the policy for your configured resources, Image Builder saves runtime details. Each row in the table represents a single runtime instance. The tab includes the following details:

  • Execution ID – Identifies the lifecycle policy runtime instance.

  • Execution status – Runtime status that reports if the policy action is currently running, ran successfully, failed, or was canceled.

  • Resource impacted – Indicates whether the runtime instance identified any image resources for lifecycle actions.

  • Start date – The timestamp when the runtime instance started.

  • End date – The timestamp when the runtime instance ended.