本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `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)
```

在指定區域中建立自訂 AWS 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`， 會 AWS ParallelCluster 執行請求驗證，而不建立任何資源。您可以使用它來驗證映像組態。預設值為 `False`。

**`rollback_on_failure`**  
如果設定為 `True`， 會在失敗時 AWS ParallelCluster 自動啟動映像堆疊轉返。預設值為 `False`。

**`region`**  
影像 AWS 區域。