Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# `pcluster list-images`
<a name="pcluster.list-images-v3"></a>

Récupérez la liste des images personnalisées existantes.

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

## Arguments nommés
<a name="pcluster-v3.list-images.namedargs"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster list-images`.

**--image-status \$1`AVAILABLE`,`PENDING`,`FAILED`\$1**  
Filtrez les images renvoyées en fonction du statut fourni.

**--debug**  
Active la journalisation du débogage.

**--next-token *NEXT\$1TOKEN***  
Jeton de l'ensemble de résultats suivant.

**--query *QUERY***  
Spécifie la JMESPath requête à exécuter sur la sortie.

**--region, -r *REGION***  
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.

**Exemple utilisant AWS ParallelCluster la version 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"
    }
  ]
}
```