Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Crea un' AWS ParallelCluster immagine personalizzata nella regione specificata.

```
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}]
```

## Argomenti denominati
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
Mostra il testo di aiuto per`pcluster build-image`.

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
Specifica il file di configurazione dell'immagine come documento YAML.

**--image-id, -i *IMAGE\$1ID***  
Specifica l'id dell'immagine che verrà creata.

**--debug**  
Attiva la registrazione di debug.

**--dryrun *DRYRUN***  
Quando`true`, il comando esegue la convalida senza creare risorse. È possibile utilizzarlo per convalidare la configurazione dell'immagine. (Il valore predefinito è.) `false`

**--query *QUERY***  
JMESPath interrogazione da eseguire in uscita.

**--region, -r *REGION***  
Specifica Regione AWS da usare. Regione AWS Deve essere specificato utilizzando l'impostazione [Region](image-builder-configuration-file-v3.md#yaml-build-image-Region) nel file di configurazione dell'immagine, la variabile di `AWS_DEFAULT_REGION` ambiente, l'`region`impostazione nella `[default]` sezione del `~/.aws/config` file o il `--region` parametro.

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
When`true`, avvia automaticamente un rollback dello stack di immagini in caso di errore. (Il valore predefinito è.) `false`

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifica uno o più validatori di configurazione da sopprimere.  
Formato: (\$1) `ALL` `type:[A-Za-z0-9]+`

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
Speciifica il livello di convalida minimo che impedirà la creazione. (Il valore predefinito è.) `ERROR`

**Esempio di utilizzo della AWS ParallelCluster versione 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"
  }
}
```

**avvertimento**  
`pcluster build-image`utilizza il VPC predefinito. Se il VPC predefinito è stato eliminato, magari utilizzando AWS Control Tower o AWS Landing Zone, l'ID della sottorete deve essere specificato nel file di configurazione dell'immagine. Per ulteriori informazioni, consulta [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).