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 list-images`
<a name="pcluster.list-images-v3"></a>

Recupera l'elenco delle immagini personalizzate esistenti.

```
pcluster list-images [-h] 
                 --image-status {AVAILABLE,PENDING,FAILED}
                [--debug]
                [--next-token NEXT_TOKEN]
                [--query QUERY]
                [--region REGION]
```

## Argomenti denominati
<a name="pcluster-v3.list-images.namedargs"></a>

**-h, --help**  
Mostra il testo di aiuto per`pcluster list-images`.

**--image-status \$1`AVAILABLE`,`PENDING`,`FAILED`\$1**  
Filtra le immagini restituite in base allo stato fornito.

**--debug**  
Abilita la registrazione del debug.

**--next-token *NEXT\$1TOKEN***  
Token per il set di risultati successivo.

**--query *QUERY***  
Specifica l' JMESPath interrogazione da eseguire sull'output.

**--region, -r *REGION***  
Specifica l'uso Regione AWS . Regione AWS Deve essere specificato utilizzando la variabile di `AWS_DEFAULT_REGION` ambiente, l'`region`impostazione nella `[default]` sezione del `~/.aws/config` file o il `--region` parametro.

**Esempio di utilizzo della AWS ParallelCluster versione 3.1.2:**

```
$ pcluster list-images --image-status AVAILABLE
{
  "images": [
    {
      "imageId": "custom-alinux2-image",
      "imageBuildStatus": "BUILD_COMPLETE",
      "ec2AmiInfo": {
        "amiId": "ami-1234abcd5678efgh"
      },
      "region": "us-east-1",
      "version": "3.1.2"
    }
  ]
}
```