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

# `build_image`
<a name="pc-py-lib-api-image-build"></a>

```
build_image(image_configuration, image_id, suppress_validators, validation_failure_level, dry_run, rollback_on_failure, region)
```

在给定区域创建自定义 Amazon ParallelCluster 镜像。参数：

**`image_configuration`（必需）**  
作为 Python 数据的映像配置。

**`image_id`（必需）**  
映像 ID。

**`suppress_validators`**  
标识一个或多个要禁止的映像配置验证器。  
格式：`(ALL | type:[A-Za-z0-9]+)`

**`validation_failure_level`**  
导致映像创建失败的最低验证级别。默认值为 `ERROR`。  
有效值：`INFO` \|`WARNING` \|`ERROR`

**`dry_run`**  
如果设置为`True`，则在不创建任何资源的情况下 Amazon ParallelCluster 执行请求验证。您可以使用此参数来验证映像配置。默认值为 `False`。

**`rollback_on_failure`**  
如果设置为`True`，则在 Amazon ParallelCluster 出现故障时自动启动映像堆栈回滚。默认值为 `False`。

**`region`**  
映像 Amazon Web Services 区域。