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 requête](#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 requête
<a name="list-images-request-body"></a>

**État de l'image**  
Filtrez les images en fonction du statut fourni.  
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 là.  
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.    
**formation des nuages StackArn**  
Le nom de ressource Amazon (ARN) de la CloudFormation pile principale.  
Type : chaîne  
**formation des nuages StackStatus**  
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'ID AMI Amazon EC2.  
Type : chaîne  
**image BuildStatus**  
É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**  
L'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'
    }
  ]
}
```

------