AWS imagebuilder documentation change
Summary
Updated documentation for viewing lifecycle policies in EC2 Image Builder. Changes include: condensed introduction, simplified section headers, more concise descriptions of policy details (status, image type, timestamps, IAM role), restructured Rules/Scope tab content, and added CLI command for viewing per-resource execution details.
Security assessment
The changes are documentation improvements focusing on clarity and conciseness without addressing security vulnerabilities. The IAM role mention remains informational without new security context. No security features were added or modified.
Diff
diff --git a/imagebuilder/latest/userguide/view-lifecycle-policy.md b/imagebuilder/latest/userguide/view-lifecycle-policy.md index 10ebf61b6..31a1f4731 100644 --- a//imagebuilder/latest/userguide/view-lifecycle-policy.md +++ b//imagebuilder/latest/userguide/view-lifecycle-policy.md @@ -11,3 +11 @@ View lifecycle policy details in the Image Builder console -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. +Use the EC2 Image Builder console, the AWS CLI, or the API to view lifecycle policy configuration, execution history, and rule definitions. @@ -24 +22 @@ On the lifecycle policy details page in the Image Builder console, you can view -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. +The lifecycle policy detail page displays a summary section and tabs with additional information. @@ -41 +39 @@ The image detail page in the Image Builder console includes a summary section, w -The summary section spans the width of the page and includes the following details. These details are always displayed. +The summary section shows these details: @@ -46 +44 @@ The summary section spans the width of the page and includes the following detai -Whether the policy is active or inactive. +Active (policy runs on schedule) or Inactive (policy is paused). @@ -51 +49 @@ Whether the policy is active or inactive. -The type of output image that Image Builder distributes when you create a new image version (AMI or container image). +Output image type: AMI or container image. @@ -56 +54 @@ The type of output image that Image Builder distributes when you create a new im -The timestamp from the creation of the lifecycle policy. +Timestamp when you created the policy. @@ -61 +59 @@ The timestamp from the creation of the lifecycle policy. -The last time the lifecycle policy was updated. +Timestamp of the most recent policy update. @@ -66 +64 @@ The last time the lifecycle policy was updated. -The last time the lifecycle policy ran. +Timestamp of the most recent policy execution. @@ -71 +69 @@ The last time the lifecycle policy ran. -The IAM role that Image Builder uses to perform lifecycle actions. +IAM role that Image Builder assumes to perform lifecycle actions. @@ -76 +74 @@ The IAM role that Image Builder uses to perform lifecycle actions. -The Amazon Resource Name (ARN) of the lifecycle policy resource. +Amazon Resource Name (ARN) of the lifecycle policy. @@ -81 +79 @@ The Amazon Resource Name (ARN) of the lifecycle policy resource. -The description for the lifecycle policy, if entered. +Policy description, if provided. @@ -85 +83 @@ The description for the lifecycle policy, if entered. -The **Rules** tab displays the lifecycle rules that you configured for the policy you're viewing. The tab includes the following details: +The **Rules** tab displays the lifecycle rules configured for this policy: @@ -87 +85 @@ The **Rules** tab displays the lifecycle rules that you configured for the polic - * **Name** – The name of the rule. These names are static, based on policy actions you can configure. + * **Name** – A fixed name that matches the policy action type: @@ -95 +93 @@ The **Rules** tab displays the lifecycle rules that you configured for the polic - * **Rule** – A short description of the action that's configured for the rule. + * **Rule** – Short description of the configured action. @@ -97 +95 @@ The **Rules** tab displays the lifecycle rules that you configured for the polic - * **Rule conditions** – Lists configuration for associated resource handling, exceptions to the rule, and retention settings, if applicable. + * **Rule conditions** – Resource handling configuration, rule exceptions, and retention settings. @@ -106 +104 @@ For more information about rule configuration, see [How lifecycle rules work](./ -The **Scope** tab displays the resource selection criteria that are configured for the policy you're viewing. The tab includes the following details: +The **Scope** tab displays the resource selection criteria for this policy: @@ -108 +106 @@ The **Scope** tab displays the resource selection criteria that are configured f - * **Filter:`type of filter`** – The filter type you used to define the scope. The filter type can be one of the following: + * **Filter:`type of filter`** – The filter type that defines the scope: @@ -110 +108 @@ The **Scope** tab displays the resource selection criteria that are configured f - * `recipes` – The recipes that were used to create the images that the lifecycle policy applies to. + * `recipes` – Recipes used to create the images this policy applies to. @@ -112 +110 @@ The **Scope** tab displays the resource selection criteria that are configured f - * `tags` – A set of tags that Image Builder uses to select image resources that the lifecycle policy applies to. + * `tags` – Tags that Image Builder uses to select images this policy applies to. @@ -114 +112 @@ The **Scope** tab displays the resource selection criteria that are configured f - * A search bar – You can filter the list by **Name** to streamline results that display in the tab. + * **Search** bar – Filters the list by **Name**. @@ -116 +114 @@ The **Scope** tab displays the resource selection criteria that are configured f - * **Name** – Each row contains a name or tag that you've configured for the filter criteria. + * **Name** – Name or tag configured as filter criteria. @@ -118 +116 @@ The **Scope** tab displays the resource selection criteria that are configured f - * **Version** – If you've configured a recipe filter, Image Builder displays the recipe version. + * **Version** – Recipe version (recipe filter only). @@ -125 +123,7 @@ The **Scope** tab displays the resource selection criteria that are configured f -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: +Image Builder saves runtime details for each policy execution. Each table row represents one execution: + + * **Execution ID** – Unique identifier for the execution instance. + + * **Execution status** – Current execution state. + + * **Resource impacted** – Indicates whether the execution identified image resources for lifecycle actions. @@ -127 +131 @@ Each time you run the policy for your configured resources, Image Builder saves - * **Execution ID** – Identifies the lifecycle policy runtime instance. + * **Start date** – Timestamp when the execution started. @@ -129 +133 @@ Each time you run the policy for your configured resources, Image Builder saves - * **Execution status** – Runtime status that reports if the policy action is currently running, ran successfully, failed, or was canceled. + * **End date** – Timestamp when the execution ended. This field is empty if the execution is in progress or pending. @@ -131 +134,0 @@ Each time you run the policy for your configured resources, Image Builder saves - * **Resource impacted** – Indicates whether the runtime instance identified any image resources for lifecycle actions. @@ -133 +135,0 @@ Each time you run the policy for your configured resources, Image Builder saves - * **Start date** – The timestamp when the runtime instance started. @@ -135 +136,0 @@ Each time you run the policy for your configured resources, Image Builder saves - * **End date** – The timestamp when the runtime instance ended. @@ -136,0 +138 @@ Each time you run the policy for your configured resources, Image Builder saves +For execution status descriptions, see [Execution statuses](./lifecycle-policy-execution.html#lifecycle-execution-statuses). @@ -137,0 +140 @@ Each time you run the policy for your configured resources, Image Builder saves +###### Viewing per-resource details @@ -138,0 +142 @@ Each time you run the policy for your configured resources, Image Builder saves +Run the [list-lifecycle-execution-resources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-lifecycle-execution-resources.html) AWS CLI command with the execution ID to view individual resource outcomes. Each entry shows the action taken, its result (succeeded, failed, or skipped), and the reason.