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

# バッチビルドの実行 (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>
   ```

   以前のバージョンのビルド入力アーティファクトを使用してビルドを実行する場合、またはビルド出力アーティファクト、環境変数、ビルド仕様、またはデフォルトのビルドタイムアウト期間の設定をオーバーライドする場合は、これを使用します。

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*  
バッチビルドのビルドアーティファクトを 1 つのアーティファクトの場所に結合するかどうかを指定するブール値。  
*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)」を参照してください。