本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

擷取與映像建置相關聯的日誌事件。

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

## 具名引數
<a name="pcluster-v3.get-image-log-events.namedargs"></a>

**-h, --help**  
顯示 的說明文字`pcluster get-image-log-events`。

**--image-id, -i *IMAGE\$1ID***  
指定影像的 ID。

**--log-stream-name *LOG\$1STREAM\$1NAME***  
指定日誌串流的名稱。您可以使用 `list-image-log-streams`命令來擷取與事件相關聯的日誌串流。

**--debug**  
啟用偵錯記錄。

**--end-time *END\$1TIME***  
指定時間範圍的結束，以 ISO 8601 格式表示 (`YYYY-MM-DDThh:mm:ssZ`例如 `2021-01-01T20:00:00Z`)。時間戳記等於或晚於此時間的事件不會包含在內。

**--limit *LIMIT***  
指定傳回的日誌事件數目上限。如果未指定值，則日誌事件的數量上限為 1 MB 的回應大小，最多 10，000 個日誌事件。

**--next-token *NEXT\$1TOKEN***  
下一組結果的字符。

**--query *QUERY***  
指定要在輸出上執行的 JMESPath 查詢。

**--region, -r *REGION***  
指定 AWS 區域 要使用的 。 AWS 區域 必須使用 `AWS_DEFAULT_REGION`環境變數、 `~/.aws/config` 檔案 `[default]`區段中的 `region`設定或 `--region` 參數來指定 。

**--start-from-head *START\$1FROM\$1HEAD***  
如果值為 `true`，則會先傳回最早的日誌事件。如果值為 `false`，則會先傳回最新的日誌事件。（預設為 `false`。)

**--start-time *START\$1TIME***  
指定時間範圍的開始，以 ISO 8601 格式表示 (`YYYY-MM-DDThh:mm:ssZ`例如 `2021-01-01T20:00:00Z`)。包含時間戳記等於或晚於此時間的事件。

**使用 3.1.2 AWS ParallelCluster 版的範例：**

```
$ 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"
    }
  ]
}
```