AWS Security ChangesHomeSearch

AWS imagebuilder: Image Builder doc history: retries, dry run, failure context

Service: imagebuilder · 2026-09-27 · Documentation low

File: imagebuilder/latest/userguide/doc-history.md

Summary

Adds several doc-history entries covering AWSTOE region/download updates, resource name to ARN mapping, AWSTOE variables, workflow step retries, dry run for create actions, and structured failure context.

Security assessment

These are documentation changelog entries for feature releases and doc updates; none reference a vulnerability, CVE, or security control.

Evidence

+Feature release: Dry run for create actions| You can validate the configuration for an Image Builder resource without creating the resource. To perform a dry run, set the `dryRun` parameter to `true` in your create request. For more information, see [Validate Image Builder resource creation with a dry run](https://docs.aws.amazon.com/imagebuilder/latest/userguide/dry-run-resources.html).| September 8, 2026  

Diff

diff --git a/imagebuilder/latest/userguide/doc-history.md b/imagebuilder/latest/userguide/doc-history.md
index 103e26b4a..434c80e62 100644
--- a//imagebuilder/latest/userguide/doc-history.md
+++ b//imagebuilder/latest/userguide/doc-history.md
@@ -17,0 +18,6 @@ Change| Description| Date
+[Update supported Regions and downloads for AWSTOE](./toe-component-manager.html)| AWSTOE is supported in all AWS Regions where Image Builder is available. The supported Regions list now refers to the Image Builder endpoints page, which reflects new Regions at launch. Also added the application download link for macOS on ARM64.| September 17, 2026  
+Resource name to ARN mapping| Documented how Image Builder generates resource ARNs from a normalized form of the resource name, and how normalization affects name uniqueness within your account for each AWS Region. For more information, see [Resource names and ARNs](https://docs.aws.amazon.com/imagebuilder/latest/userguide/how-image-builder-works.html#ibhow-resource-names).| September 9, 2026  
+Variables in AWSTOE component documents| Documented AWSTOE runtime variables that you can reference in a component document, including environment variables (`env:`), instance metadata variables (`aws:imds:`), and context variables (`context:`). Also documented the environment variables that Image Builder provides to components. For more information, see [Use variables in your custom component document](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-user-defined-variables.html) and [Environment variables that Image Builder provides](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-user-defined-variables.html#toe-ib-env-variables).| September 8, 2026  
+Feature release: Workflow step retries| You can configure Image Builder to automatically retry a workflow step that fails. To set up retries, add the `retry` attribute to a step in your workflow document. For more information, see [Retry failed workflow steps](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-workflow-create-document.html#wfdoc-step-retry).| September 8, 2026  
+Feature release: Dry run for create actions| You can validate the configuration for an Image Builder resource without creating the resource. To perform a dry run, set the `dryRun` parameter to `true` in your create request. For more information, see [Validate Image Builder resource creation with a dry run](https://docs.aws.amazon.com/imagebuilder/latest/userguide/dry-run-resources.html).| September 8, 2026  
+Structured failure context| Documented the failure context that Image Builder returns on a failed image, which names the stage (`imageStatus`), the workflow step, the component step, and the destination Regions that caused the failure. For more information, see [Find the cause of a failed image build with failure context](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-failure-context.html).| September 4, 2026