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

# 執行批次建置 (AWS CLI)
<a name="run-batch-build-cli"></a>

1. 使用下列其中一種方式，執行 `start-build-batch` 命令：

   ```
   aws codebuild start-build-batch --project-name <project-name>
   ```

   如果您想要執行的建置使用建置輸入成品和組建專案現有設定的最新版本，則請使用此命令。

   ```
   aws codebuild start-build-batch --generate-cli-skeleton > <json-file>
   ```

   如果您想要執行的建置使用建置輸入成品的舊版本，或者想要覆寫建置輸出成品、環境變數、buildspec 或預設建置逾時期間的設定，則請使用此命令。

1. 如果您使用 `--project-name`選項執行 **start-build-batch**命令，請將 *<project-name>* 取代為建置專案的名稱，然後跳至此程序的步驟 6。若要取得組建專案清單，請參閱[檢視組建專案名稱](view-project-list.md)。

1. 如果您使用 `--idempotency-token`選項執行 **start-build-batch**命令，`start-build-batch`則請求中會包含唯一的區分大小寫識別符或字符。此字符在 請求之後的 5 分鐘內有效。如果您使用相同的字符重複`start-build-batch`請求，但變更參數，CodeBuild 會傳回參數不相符錯誤。

1. 如果您使用 `--generate-cli-skeleton`選項執行 **start-build-batch**命令，JSON 格式的資料會輸出到 *<json-file>* 檔案。此檔案類似於 **start-build**命令產生的骨架，並新增下列物件。如需常見物件的詳細資訊，請參閱 [執行建置 (AWS CLI)](run-build-cli.md)。

   修改此檔案以新增任何建置覆寫，並儲存結果。

   ```
     "buildBatchConfigOverride": {
       "combineArtifacts": combineArtifacts,
       "restrictions": {
         "computeTypesAllowed": [
           allowedComputeTypes
         ],
         "maximumBuildsAllowed": maximumBuildsAllowed
       },
       "serviceRole": "batchServiceRole",
       "timeoutInMins": batchTimeout
     }
   ```

   `buildBatchConfigOverride` 物件是 [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html) 結構，其中包含此建置的批次建置組態覆寫。  
*combineArtifacts*  
布林值，指定是否應將批次組建的組建成品合併為單一成品位置。  
*allowedComputeTypes*  
字串陣列，指定批次建置允許的運算類型。如需這些值，請參閱[建置環境運算類型](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html)。  
*maximumBuildsAllowed*  
指定允許的建置數目上限。  
*batchServiceRole*  
指定批次建置專案的服務角色 ARN。  
*batchTimeout*  
指定批次建置必須完成的時間上限 (以分鐘為單位)。

1. 切換到包含您剛儲存之檔案的目錄，然後再次執行 `start-build-batch` 命令。

   ```
   aws codebuild start-build-batch --cli-input-json file://start-build.json
   ```

1. 如果成功，則 [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html) 物件的 JSON 表示法會出現在主控台輸出中。如需此資料的範例，請參閱 [StartBuildBatch 回應語法](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax)。