As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Exporta os logs da pilha do construtor de imagens para um arquivo `tar.gz` local passando por um bucket do 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**  
O `export-image-logs` comando espera que o CloudWatch Logs conclua a exportação dos registros, portanto, espera-se que ele passe um período sem nenhuma saída.

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

**-h, --help**  
Mostra o texto de ajuda para `pcluster export-image-logs`.

**--bucket {{BUCKET\_NAME}}**  
Especifica o nome do bucket do Amazon S3 para o qual exportar logs criação de imagem. Deve estar na mesma região da imagem.  
+ Você deve adicionar permissões à política de bucket do Amazon S3 para conceder CloudWatch acesso. Para obter mais informações, consulte [Definir permissões em um bucket do Amazon S3 no Guia](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) do *usuário de CloudWatch registros*.
+ **A partir da AWS ParallelCluster versão **3.12.0**, a `--bucket` opção é opcional.** Se a opção não for especificada, o bucket padrão AWS ParallelCluster regional (`parallelcluster-hash-v1-DO-NOT-DELETE`) será usado ou, se `CustomS3Bucket` for especificado na configuração da imagem, ele será usado.
Se o bucket AWS ParallelCluster padrão for usado, o pcluster se encarregará de configurar a política do bucket. Se você personalizar a política de bucket antes de atualizar para a AWS ParallelCluster versão **3.12.0**, a política de bucket será substituída e você precisará reaplicar as alterações.

**--image-id, -i {{IMAGE\_ID}}**  
O ID da imagem cujos logs serão exportados.

**--bucket-prefix {{BUCKET\_PREFIX}}**  
Especifica o caminho no bucket do Amazon S3 para o qual os dados de log exportados devem ser armazenados.  
Por padrão, o prefixo do bucket é:  

```
{{ami-id}}-logs-{{202209061743}}.tar.gz
```
`{{202209061743}}` é a hora atual no formato `%Y%m%d%H%M`.  
A partir da AWS ParallelCluster versão **3.12.0**, se você não especificar a `--bucket` opção e usar o AWS ParallelCluster bucket padrão, não poderá exportar registros para a `parallelcluster/` pasta, pois é uma pasta protegida reservada para uso interno.

**--debug**  
Habilita o log de depuração.

**--end-time {{END\_TIME}}**  
Especifica o final do intervalo de tempo para coletar eventos de log, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`'). Eventos com uma marca de data/hora igual ou posterior a esse horário não estão incluídos. Elementos de tempo (por exemplo, minutos e segundos) podem ser omitidos. O valor padrão é o horário atual.

**--keep-s3-objects {{KEEP\_S3\_OBJECTS}}**  
Se for `true`, as exportações de objetos exportados para o Amazon S3 serão mantidas. (Padronizado como `false`.)

**--output-file {{OUTPUT\_FILE}}**  
Especifica o caminho do arquivo onde será salvo o arquivamento de log. Se isso for fornecido, os logs serão salvos localmente. Caso contrário, eles serão enviados para o Amazon S3 com o URL retornado na saída. O padrão é fazer upload para o Amazon S3.

**--region, -r {{REGION}}**  
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando a variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.

**--start-time {{START\_TIME}}**  
Especifica o início do intervalo de tempo, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`). Eventos de log com uma marca de data/hora igual ou posterior a esse horário estão incluídos. Se não for especificado, o padrão é a hora em que o cluster foi criado.

**Exemplo usando a AWS ParallelCluster versão 3.1.4:**

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