Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `pcluster export-image-logs`
<a name="pcluster.export-image-logs-v3"></a>

Esporta i log dello stack di image builder in un `tar.gz` archivio locale passando attraverso un Amazon S3 Bucket.

```
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]
```

**Nota**  
Il `export-image-logs` comando attende che CloudWatch Logs completi l'esportazione dei log, quindi si prevede che trascorra un periodo di tempo senza alcun output.

## Argomenti denominati
<a name="pcluster-v3.export-image-logs.namedargs"></a>

**-h, --help**  
Mostra il testo di aiuto per`pcluster export-image-logs`.

**--bucket *BUCKET\$1NAME***  
Specifica il nome del bucket Amazon S3 in cui esportare i log di creazione dell'immagine. Deve trovarsi nella stessa regione dell'immagine.  
+ È necessario aggiungere le autorizzazioni alla policy del bucket di Amazon S3 per concedere l'accesso. CloudWatch *Per ulteriori informazioni, consulta [Impostare le autorizzazioni su un bucket Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) nella CloudWatch Logs User Guide.*
+ **A partire dalla AWS ParallelCluster versione **3.12.0**, l'opzione è facoltativa. `--bucket`** Se l'opzione non è specificata, verrà utilizzato il bucket predefinito AWS ParallelCluster regionale (`parallelcluster-hash-v1-DO-NOT-DELETE`) oppure, se specificato nella configurazione dell'immagine, verrà utilizzato quello. `CustomS3Bucket`
Se viene utilizzato il bucket AWS ParallelCluster predefinito, pcluster si occuperà di configurare la policy del bucket. Se personalizzi la policy del bucket prima di eseguire l'aggiornamento alla AWS ParallelCluster versione **3.12.0**, la policy del bucket verrà sovrascritta e dovrai riapplicare le modifiche.

**--image-id, -i *IMAGE\$1ID***  
L'ID dell'immagine i cui registri verranno esportati.

**--bucket-prefix *BUCKET\$1PREFIX***  
Speciifica il percorso nel bucket Amazon S3 in cui devono essere archiviati i dati dei log esportati.  
Per impostazione predefinita, il prefisso bucket è:  

```
ami-id-logs-202209061743.tar.gz
```
`202209061743`è l'ora corrente nel formato. `%Y%m%d%H%M`  
A partire dalla AWS ParallelCluster versione **3.12.0**, se non si specifica l'`--bucket`opzione e si utilizza il AWS ParallelCluster bucket predefinito, non è possibile esportare i registri nella `parallelcluster/` cartella, poiché si tratta di una cartella protetta riservata all'uso interno.

**--debug**  
Abilita la registrazione di debug.

**--end-time *END\$1TIME***  
Specifica la fine dell'intervallo di tempo per la raccolta degli eventi di registro, espresso in formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`ad esempio '). `2021-01-01T20:00:00Z` Gli eventi con un timestamp uguale o successivo a questo orario non sono inclusi. Gli elementi temporali (ad esempio minuti e secondi) possono essere omessi. Il valore predefinito è l'ora corrente.

**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***  
Se`true`, le esportazioni degli oggetti esportati in Amazon S3 vengono mantenute. (Il valore predefinito è.) `false`

**--output-file *OUTPUT\$1FILE***  
Speciifica il percorso del file in cui salvare l'archivio di registro. Se viene fornito, i registri vengono salvati localmente. Altrimenti vengono caricati su Amazon S3 con l'URL restituito nell'output. L'impostazione predefinita è il caricamento su Amazon S3.

**--region, -r *REGION***  
Specifica l'uso Regione AWS . Regione AWS Deve essere specificato utilizzando la variabile di `AWS_DEFAULT_REGION` ambiente, l'`region`impostazione nella `[default]` sezione del `~/.aws/config` file o il `--region` parametro.

**--start-time *START\$1TIME***  
Speciifica l'inizio dell'intervallo di tempo, espresso nel formato ISO 8601 (ad `YYYY-MM-DDThh:mm:ssZ` esempio`2021-01-01T20:00:00Z`). Sono inclusi gli eventi di registro con un timestamp uguale a questo orario o successivo a tale ora. Se non specificato, l'impostazione predefinita è l'ora di creazione del cluster.

**Esempio di utilizzo della AWS ParallelCluster versione 3.1.4:**

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