Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejecutar una compilación por lotes (AWS CLI)
<a name="run-batch-build-cli"></a>

1. Ejecute el comando `start-build-batch` de una de las siguientes formas:

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

   Utilice esta opción si desea ejecutar una compilación que utilice la última versión del artefacto de entrada de la compilación y la configuración existente del proyecto de compilación.

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

   Utilice esta opción si desea ejecutar una versión de compilación con una versión anterior del artefacto de entrada de compilación o si desea anular la configuración de los artefactos de salida de compilación, variables de entorno, especificación de compilación o período de tiempo de espera de compilación predeterminado.

1. Si ejecuta el **start-build-batch** comando con la `--project-name` opción, {{<project-name>}} sustitúyalo por el nombre del proyecto de compilación y, a continuación, vaya al paso 6 de este procedimiento. Para obtener una lista de proyectos de compilación, consulte [Visualización de los nombres de los proyectos de compilación](view-project-list.md).

1. Si ejecuta el comando **start-build-batch** con la opción `--idempotency-token`, se incluye un identificador único en el que se distingue entre mayúsculas y minúsculas, o token, con la solicitud de `start-build-batch`. El token es válido durante 5 minutos después de la solicitud. Si repites la `start-build-batch` solicitud con el mismo token, pero cambias un parámetro, se produce un error de CodeBuild discordancia entre los parámetros.

1. Si ejecuta el **start-build-batch** comando con la `--generate-cli-skeleton` opción, los datos con formato JSON se envían al archivo. {{<json-file>}} Este archivo es similar al esqueleto producido por el comando **start-build**, con la incorporación del objeto siguiente. Para obtener más información acerca de los objetos comunes, consulte [Ejecutar una compilación (AWS CLI)](run-build-cli.md).

   Modifique este archivo para añadir cualquier modificación a la compilación y guarde los resultados.

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

   El `buildBatchConfigOverride` objeto es una [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html)estructura que contiene las modificaciones de la configuración de compilación por lotes para esta compilación.  
{{combineArtifacts}}  
Especifica si los artefactos de compilación para la compilación por lotes se deben combinar en una única ubicación de artefactos.  
{{allowedComputeTypes}}  
Una matriz de cadenas que especifican los tipos de computación permitidos para la compilación por lotes. Consulte los valores en [Tipos de computación del entorno de compilación](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html).   
{{maximumBuildsAllowed}}  
Especifica el número máximo de compilaciones permitidas.  
{{batchServiceRole}}  
Especifica el ARN del rol de servicio para el proyecto de compilación por lotes.  
{{batchTimeout}}  
Especifica la cantidad máxima de tiempo, en minutos, en que se debe completar la compilación por lotes.

1. Cambie al directorio que contiene el archivo que acaba de guardar y ejecute de nuevo el comando `start-build-batch`.

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

1. Si se ejecuta correctamente, la representación JSON de un [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html)objeto aparece en la salida de la consola. Consulte la [sintaxis de StartBuildBatch respuesta](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax) para ver un ejemplo de estos datos.