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 comando **start-build-batch** con la opción `--project-name`, sustituya *<project-name>* por el nombre del proyecto de compilación y 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 repite la solicitud `start-build-batch` con el mismo token, pero cambia un parámetro, CodeBuild devuelve un error de coincidencia de parámetros.

1. Si ejecuta el comando **start-build-batch** con la opción `--generate-cli-skeleton`, se envían datos en formato JSON 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 objeto `buildBatchConfigOverride` es una estructura [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html) que contiene las modificaciones a 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 salida de la consola muestra la representación en JSON de un objeto [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html). Consulte [Sintaxis de respuesta de StartBuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax) para ver un ejemplo de estos datos.