View a markdown version of this page

ドライランによる Image Builder リソース作成の検証 - EC2 イメージビルダー

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ドライランによる 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.