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.

# `pcluster build-image`
<a name="pcluster.build-image-v3"></a>

Cree una AWS ParallelCluster imagen personalizada en la región especificada.

```
pcluster build-image [-h]
                 --image-configuration IMAGE_CONFIGURATION 
                 --image-id IMAGE_ID
                [--debug]
                [--dryrun DRYRUN]
                [--query QUERY]
                [--region REGION]
                [--rollback-on-failure ROLLBACK_ON_FAILURE]
                [--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## Argumentos con nombre
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
Muestra el texto de ayuda de `pcluster build-image`.

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
Especifica el archivo de configuración de la imagen como un documento YAML.

**--image-id, -i *IMAGE\$1ID***  
Especifica el identificador de la imagen que se va a crear.

**--debug**  
Activar el registro de depuración.

**--dryrun *DRYRUN***  
Cuando se establece en `true`, el comando realiza la validación sin crear ningún recurso. Puede usarlo para validar la configuración de la imagen. (el valor predeterminado es `false`).

**--query *QUERY***  
JMESPath consulta para realizar en la salida.

**--region, -r *REGION***  
Especifica el Región de AWS que se va a utilizar. Región de AWS Debe especificarse mediante el ajuste [Región](image-builder-configuration-file-v3.md#yaml-build-image-Region) del archivo de configuración de la imagen, la variable de `AWS_DEFAULT_REGION` entorno, el `region` ajuste de la `[default]` sección del `~/.aws/config` archivo o el `--region` parámetro.

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
Si se establece en `true`, inicia automáticamente una reversión de la pila de la imagen en caso de que se produzca un error (el valor predeterminado es `false`).

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifica uno o más validadores de configuración para suprimirlos.  
Formato: (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
Especifica el nivel mínimo de validación que provocará un error en la creación (el valor predeterminado es `ERROR`).

**Ejemplo que utiliza AWS ParallelCluster la versión 3.1.2:**

```
$ pcluster build-image --image-configuration image-config.yaml --image-id custom-alinux2-image
{
  "image": {
    "imageId": "custom-alinux2-image",
    "imageBuildStatus": "BUILD_IN_PROGRESS",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
    "region": "us-east-1",
    "version": "3.1.2"
  }
}
```

**aviso**  
`pcluster build-image` utiliza la VPC predeterminada. Si se ha eliminado la VPC predeterminada, quizás mediante AWS Control Tower una zona de AWS aterrizaje, se debe especificar el ID de subred en el archivo de configuración de la imagen. Para obtener más información, consulte [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).