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.

# listOfficialImages
<a name="list-official-images"></a>

Récupérez la liste des images AWS ParallelCluster officielles.

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

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

```
GET /v3/images/official
{  
  "architecture": "string",
  "os": "string",
  "region": "string"
}
```

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

**application**  
Filtrer par architecture. Par défaut, il n'y a aucun filtrage.  
Type : chaîne  
Valeurs valides : `x86_64 | arm64`  
Obligatoire : non

**os**  
Filtrer par distribution du système d'exploitation. Par défaut, il n'y a aucun filtrage.  
Type : chaîne  
Valeurs valides : `alinux2 | alinux2023 | ubuntu2404 | ubuntu2204 | rhel8 | rhel9`  
Obligatoire : non

**region**  
Le Région AWS dans lequel les images officielles sont répertoriées.  
Type : chaîne  
Obligatoire : non

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

```
{
  "images": [
    {
      "architecture": "string",
      "amiId": "string",
      "name": "string",
      "os": "string",
      "version": "string"
    }
  ]
}
```

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

**images**    
**AMID**  
ID de l'AMI.  
Type : chaîne  
**application**  
L'architecture de l'AMI.  
Type : chaîne  
**name**  
Le nom de l'AMI.  
Type : chaîne  
**os**  
Le système d'exploitation AMI.  
Type : chaîne  
**version**  
La AWS ParallelCluster version.  
Type : chaîne

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

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

**Demande**

```
$ list_official_images()
```

**Réponse 200**

```
{
  'images': [ 
    {
      'ami_id': 'ami-015cfeb4e0d6306b2',
      'architecture': 'x86_64',
      'name': 'aws-parallelcluster-3.2.1-ubuntu-2204-lts-hvm-x86_64-202202261505 '
      '2022-02-26T15-08-34.759Z',
      'os': 'ubuntu2204',
      'version': '3.2.1'
    },
    ...
  ]
}
```

------