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.

# Images de la liste
<a name="list-images"></a>

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

**Topics**
+ [Syntaxe de demande](#list-images-request)
+ [Corps de la demande](#list-images-request-body)
+ [Syntaxe de réponse](#list-images-response)
+ [Corps de la réponse](#list-images-response-body)
+ [Exemple](#list-images-example)

## Syntaxe de demande
<a name="list-images-request"></a>

```
GET /images/custom
{
  "imageStatus": "string",
  "nextToken": "string",
  "region": "string"
}
```

## Corps de la demande
<a name="list-images-request-body"></a>

**État de l'image**  
Filtrez les images en fonction du statut indiqué.  
Type : chaîne  
Valeurs valides : `AVAILABLE | PENDING | FAILED`  
Obligatoire : oui

**nextToken**  
Jeton de l'ensemble de résultats suivant.  
Type : chaîne  
Obligatoire : non

**region**  
Ces Région AWS images sont dedans.  
Type : chaîne  
Obligatoire : non

## Syntaxe de réponse
<a name="list-images-response"></a>

```
{
  "nextToken": "string",
  "images": [
    {
      "imageId": "string",
      "ec2AmiInfo": {
        "amiId": "string"
      },
      "region": "string",
      "version": "string",
      "cloudformationStackArn": "string",
      "imageBuildStatus": "BUILD_IN_PROGRESS",
      "cloudformationStackStatus": "CREATE_IN_PROGRESS"
    }
  ]
}
```

## Corps de la réponse
<a name="list-images-response-body"></a>

**images**  
Une liste d'images.    
**cloudformationStackArn**  
Le nom de ressource Amazon (ARN) de la CloudFormation pile principale.  
Type : chaîne  
**cloudformationStackStatus**  
L'état de la CloudFormation pile.  
Type : chaîne  
Valeurs valides : `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE`  
**ec2 AmiInfo**    
**ami\_id**  
L'identifiant Amazon EC2 AMI.  
Type : chaîne  
**imageBuildStatus**  
État de création de l'image.  
Valeurs valides : `BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE`  
Type : chaîne  
**imageId**  
ID de l'image.  
Type : chaîne  
**region**  
L' Région AWS endroit dans lequel l'image est créée.  
Type : chaîne  
**version**  
 AWS ParallelCluster Version utilisée pour créer l'image.  
Type : chaîne

**nextToken**  
Jeton qui peut être utilisé pour obtenir l'ensemble de résultats suivant, ou `null`, s'il n'y a pas de résultats supplémentaires.  
Type : chaîne

## Exemple
<a name="list-images-example"></a>

------
#### [ Python ]

**Demande**

```
$ list_images({{"AVAILABLE"}})
```

**Réponse 200**

```
{
  'images': [
    {
      'ec2_ami_info': {
        'ami_id': 'ami-abcdef01234567890'
      },
      'image_build_status': 'BUILD_COMPLETE',
      'image_id': 'custom-image',
      'region': 'us-east-1',
      'version': '3.2.1'
    }
  ]
}
```

------