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 get-image-log-events`
<a name="pcluster.get-image-log-events-v3"></a>

Recupere os eventos de log associados a uma criação de imagem.

```
pcluster get-image-log-events [-h] 
                 --image-id IMAGE_ID                               
                 --log-stream-name LOG_STREAM_NAME
                [--debug]
                [--end-time END_TIME]
                [--limit LIMIT]
                [--next-token NEXT_TOKEN]                              
                [--query QUERY]                               
                [--region REGION]                              
                [--start-from-head START_FROM_HEAD]
                [--start-time START_TIME]
```

## Argumentos nomeados
<a name="pcluster-v3.get-image-log-events.namedargs"></a>

**-h, --help**  
Mostra o texto de ajuda para `pcluster get-image-log-events`.

**--image-id, -i *IMAGE\$1ID***  
Especifica o ID da imagem.

**--log-stream-name *LOG\$1STREAM\$1NAME***  
Especifica o nome do fluxo de logs. Você pode usar o comando `list-image-log-streams` para recuperar um fluxo de logs associado a um evento ou eventos.

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

**--end-time *END\$1TIME***  
Especifica o final do intervalo de tempo, 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.

**--limit *LIMIT***  
Especifica o número de eventos de log retornados pela consulta. Se um valor não for especificado, o máximo será o máximo de eventos de log que couberem em um tamanho de resposta de 1 MB, com até 10.000 eventos de log.

**--next-token *NEXT\$1TOKEN***  
O token para o próximo conjunto de resultados.

**--query *QUERY***  
Especifica a JMESPath consulta a ser executada na saída.

**--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-from-head *START\$1FROM\$1HEAD***  
Se o valor for `true`, os primeiros eventos de log serão retornados primeiro. Se o valor for `false`, os eventos de log mais recentes serão retornados primeiro. (Padronizado como `false`.)

**--start-time *START\$1TIME***  
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 com uma marca de data/hora igual ou posterior a esse horário estão incluídos.

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

```
$ pcluster get-image-log-events --image-id custom-alinux2-image --region us-east-1 --log-stream-name 3.1.2/1 --limit 3
   {
  "nextToken": "f/36778317771100849897800729464621464113270312017760944178/s",
  "prevToken": "b/36778317766952911290874033560295820514557716777648586800/s",
  "events": [
    {
      "message": "ExecuteBash: FINISHED EXECUTION",
      "timestamp": "2022-04-05T22:13:26.633Z"
    },
    {
      "message": "Document arn:aws:imagebuilder:us-east-1:123456789012:component/parallelclusterimage-test-1234abcd-56ef-78gh-90ij-abcd1234efgh/3.1.2/1",
      "timestamp": "2022-04-05T22:13:26.741Z"
    },
    {
      "message": "TOE has completed execution successfully",
      "timestamp": "2022-04-05T22:13:26.819Z"
    }
  ]
}
```