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

# ドライランによる Image Builder リソース作成の検証
<a name="dry-run-resources"></a>

ドライランでは、リソースを作成することなく、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.
```