View a markdown version of this page

通过试运行验证 Image Builder 资源的创建 - EC2 Image Builder

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

通过试运行验证 Image Builder 资源的创建

通过试运行，您可以在不创建资源的情况下检查创建 Image Builder 资源的请求是否成功。当您在请求true中将dryRun参数设置为时，Image Builder 会验证所需的权限和请求参数，然后在创建任何内容之前停止。结果是以下之一：

  • 如果验证成功，则请求失败并DryRunOperationException显示错误。此错误表示请求有效，如果没有该dryRun参数，资源创建本来会成功。

  • 如果验证失败，则请求返回的错误与不带dryRun参数时返回的错误相同，例如InvalidParameterValueException或ResourceAlreadyExistsException。

在这两种情况下，Image Builder 都不会创建资源。试运行可为您提供有关资源配置的即时反馈。这对于创建 Image Builder 资源的自动化和 AI 代理特别有用。此类工具可以在创建任何内容之前验证每个配置并纠正错误。

以下创建操作支持该dryRun参数：

  • CreateComponent

  • CreateContainerRecipe

  • CreateDistributionConfiguration

  • CreateImagePipeline

  • CreateImageRecipe

  • CreateInfrastructureConfiguration

  • CreateLifecyclePolicy

  • CreateWorkflow

注意

该CreateImage操作不支持该dryRun参数，因为它会启动映像构建，而不是创建配置资源。

从中进行试运行 AWS CLI

以下示例说明如何使用create-infrastructure-configuration命令验证基础设施配置。该--dry-run选项将请求变成试运行。

aws imagebuilder create-infrastructure-configuration \
    --name my-example-infrastructure-configuration \
    --instance-profile-name EC2InstanceProfileForImageBuilder \
    --dry-run

如果配置有效，则该命令将返回以下错误以表明请求会成功。

An error occurred (DryRunOperationException) when calling the CreateInfrastructureConfiguration operation: Request would have succeeded, but dryRun flag is set.