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\_NAME}}**  
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\_ID}}**  
L'ID dell'immagine i cui registri verranno esportati.

**--bucket-prefix {{BUCKET\_PREFIX}}**  
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\_TIME}}**  
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\_S3\_OBJECTS}}**  
Se`true`, le esportazioni degli oggetti esportati in Amazon S3 vengono mantenute. (Il valore predefinito è.) `false`

**--output-file {{OUTPUT\_FILE}}**  
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\_TIME}}**  
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..."
}
```