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 export-image-logs`
<a name="pcluster.export-image-logs-v3"></a>

Exportez les journaux de la pile du générateur d'images vers une `tar.gz` archive locale en les faisant passer par un compartiment Amazon S3.

```
pcluster export-image-logs [-h]
                 --image-id IMAGE_ID
                [--bucket BUCKET]
                [--bucket-prefix BUCKET_PREFIX]
                [--debug]                         
                [--end-time END_TIME]
                [--keep-s3-objects KEEP_S3_OBJECTS]
                [--output-file OUTPUT_FILE]
                [--region REGION]
                [--start-time START_TIME]
```

**Note**  
La `export-image-logs` commande attend que CloudWatch Logs termine l'exportation des journaux. On s'attend donc à ce qu'elle passe un certain temps sans aucune sortie.

## Arguments nommés
<a name="pcluster-v3.export-image-logs.namedargs"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster export-image-logs`.

**--bucket *BUCKET\$1NAME***  
Spécifie le nom du compartiment Amazon S3 vers lequel exporter les journaux de création d'images. Il doit se trouver dans la même région que l'image.  
+ Vous devez ajouter des autorisations à la politique du compartiment Amazon S3 pour accorder CloudWatch l'accès. Pour plus d'informations, consultez la section [Définir des autorisations sur un compartiment Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) dans le *Guide de l'utilisateur CloudWatch des journaux*.
+ **À partir de AWS ParallelCluster la version **3.12.0**, l'`--bucket`option est facultative.** Si l'option n'est pas spécifiée, soit le compartiment AWS ParallelCluster régional par défaut (`parallelcluster-hash-v1-DO-NOT-DELETE`) sera utilisé, soit s'il `CustomS3Bucket` est spécifié dans la configuration de l'image, il sera utilisé.
Si le bucket AWS ParallelCluster par défaut est utilisé, pcluster se chargera de configurer la politique du bucket. Si vous personnalisez la politique de compartiment avant de passer à la AWS ParallelCluster version **3.12.0**, la politique de compartiment sera remplacée et vous devrez réappliquer les modifications.

**--image-id, -i *IMAGE\$1ID***  
ID de l'image dont les journaux seront exportés.

**--bucket-prefix *BUCKET\$1PREFIX***  
Spécifie le chemin dans le compartiment Amazon S3 où les données des journaux exportés doivent être stockées.  
Par défaut, le préfixe du bucket est :  

```
ami-id-logs-202209061743.tar.gz
```
`202209061743`est l'heure actuelle au `%Y%m%d%H%M` format.  
À partir de AWS ParallelCluster la version **3.12.0**, si vous ne spécifiez pas l'`--bucket`option et n'utilisez pas le AWS ParallelCluster bucket par défaut, vous ne pouvez pas exporter les journaux vers le `parallelcluster/` dossier, car il s'agit d'un dossier protégé réservé à un usage interne.

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

**--end-time *END\$1TIME***  
Spécifie la fin de la plage de temps pour collecter les événements du journal, exprimée au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple `2021-01-01T20:00:00Z` '). Les événements dont l'horodatage est égal ou supérieur à cette heure ne sont pas inclus. Les éléments temporels (minutes et secondes, par exemple) peuvent être omis. La valeur par défaut est l'heure actuelle.

**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***  
Dans `true` ce cas, les objets exportés exportés vers Amazon S3 sont conservés. (La valeur par défaut est`false`.)

**--output-file *OUTPUT\$1FILE***  
Spécifie le chemin du fichier dans lequel enregistrer l'archive du journal. Si cela est fourni, les journaux sont enregistrés localement. Sinon, ils sont chargés sur Amazon S3 avec l'URL renvoyée dans la sortie. Par défaut, le téléchargement vers Amazon S3 est effectué.

**--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.

**--start-time *START\$1TIME***  
Spécifie le début de la plage horaire, exprimé au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple`2021-01-01T20:00:00Z`). Les événements du journal dont l'horodatage est égal à cette heure ou à une date ultérieure sont inclus. Si ce n'est pas spécifié, la valeur par défaut est l'heure à laquelle le cluster a été créé.

**Exemple utilisant AWS ParallelCluster la version 3.1.4 :**

```
$ pcluster export-image-logs --bucket image-v3-bucket --image-id ami-1234abcd5678efgh
{
  "url": "https://image-v3-bucket..."
}
```