Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Exporte los registros de la pila del generador de imágenes en un archivo `tar.gz` local pasándolos por un bucket de 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}}]
```

**nota**  
El `export-image-logs` comando espera a que CloudWatch Logs complete la exportación de los registros, por lo que se espera que pase un período de tiempo sin ningún resultado.

## Argumentos con nombre
<a name="pcluster-v3.export-image-logs.namedargs"></a>

**-h, --help**  
Muestra el texto de ayuda de `pcluster export-image-logs`.

**--bucket {{BUCKET\_NAME}}**  
Especifica el nombre del bucket de Amazon S3 al que se exportarán los registros de la creación de imágenes. Tiene que estar en la misma región que la imagen.  
+ Debe añadir permisos a la política de buckets de Amazon S3 para conceder el CloudWatch acceso. Para obtener más información, consulte [Establecer permisos en un bucket de Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) en la *Guía del usuario de CloudWatch Logs*.
+ **A partir de AWS ParallelCluster la versión **3.12.0**, la `--bucket` opción es opcional.** Si no se especifica la opción, se utilizará el bucket AWS ParallelCluster regional predeterminado (`parallelcluster-hash-v1-DO-NOT-DELETE`) o, si `CustomS3Bucket` se especifica en la configuración de la imagen, se utilizará ese bucket.
Si se usa el bucket AWS ParallelCluster predeterminado, pcluster se encargará de configurar la política del bucket. Si personaliza la política de bucket antes de actualizar a la AWS ParallelCluster versión **3.12.0**, la política de bucket se anulará y tendrá que volver a aplicar los cambios.

**--image-id, -i {{IMAGE\_ID}}**  
El identificador de la imagen cuyos registros se exportarán.

**--bucket-prefix {{BUCKET\_PREFIX}}**  
Especifica la ruta en el bucket de Amazon S3 donde se almacenará la información de los registros exportados.  
De forma predeterminada, el prefijo del bucket es:  

```
{{ami-id}}-logs-{{202209061743}}.tar.gz
```
`{{202209061743}}` es la hora actual en formato `%Y%m%d%H%M`.  
A partir de la AWS ParallelCluster versión **3.12.0**, si no especificas la `--bucket` opción y utilizas el AWS ParallelCluster depósito predeterminado, no podrás exportar los registros a la `parallelcluster/` carpeta, ya que se trata de una carpeta protegida reservada para uso interno.

**--debug**  
Habilita del registro de depuración.

**--end-time {{END\_TIME}}**  
Especifica el final del intervalo de tiempo para recopilar los eventos del registro, expresado en formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por ejemplo `2021-01-01T20:00:00Z`). No se incluyen los eventos con una marca de tiempo igual o posterior a esta hora. Se pueden omitir los elementos de tiempo (por ejemplo, minutos y segundos). El valor predeterminado es la hora actual.

**--keep-s3-objects {{KEEP\_S3\_OBJECTS}}**  
Si se establece en `true`, se conservan las exportaciones de objetos exportados a Amazon S3. (el valor predeterminado es `false`).

**--output-file {{OUTPUT\_FILE}}**  
Especifica la ruta del archivo en la que se guardará el archivo de registro. Si se proporciona, los registros se guardan localmente. De lo contrario, se cargan en Amazon S3 con la URL devuelta en la salida. De forma predeterminada, se cargan en Amazon S3.

**--region, -r {{REGION}}**  
Especifica el que se va Región de AWS a utilizar. Región de AWS Debe especificarse mediante la variable de `AWS_DEFAULT_REGION` entorno, la `region` configuración de la `[default]` sección del `~/.aws/config` archivo o el `--region` parámetro.

**--start-time {{START\_TIME}}**  
Especifica el inicio del intervalo de tiempo, expresado en formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por ejemplo `2021-01-01T20:00:00Z`). Se incluyen los eventos de registro con una marca de tiempo igual o posterior a esta hora. Si no se especifica, el valor predeterminado es la hora en que se creó el clúster.

**Ejemplo que utiliza AWS ParallelCluster la versión 3.1.4:**

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