pcluster get-image-log-events - AWS ParallelCluster
命名的参数

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

pcluster get-image-log-events

检索与映像构建相关的日志事件。

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]

命名的参数

-h, --help

显示 pcluster get-image-log-events 的帮助文本。

--image-id, -i IMAGE_ID

指定映像的 ID。

--log-stream-name LOG_STREAM_NAME

指定日志流的名称。您可以使用 list-image-log-streams 命令来检索与一个或多个事件关联的日志流。

--debug

启用调试日志记录。

--end-time END_TIME

指定时间范围的结束时间，以 ISO 8601 格式（YYYY-MM-DDThh:mm:ssZ，例如 2021-01-01T20:00:00Z）表示。不包括时间戳等于或晚于该时间的事件。

--limit LIMIT

指定返回的日志事件的最大数量。如果不指定值，则最大值为 1 MB 的响应大小所能容纳的日志事件数量，最多可达 10000 个日志事件。

--next-token NEXT_TOKEN

用于获取下一组结果的令牌。

--query QUERY

指定要对输出执行的 JMESPath 查询。

--region, -r REGION

指定 AWS 区域 要使用的。 AWS 区域 必须使用AWS_DEFAULT_REGION环境变量、~/.aws/config文件[default]部分中的region设置或--region参数来指定。

--start-from-head START_FROM_HEAD

如果值为 true，则最先返回最早的日志事件。如果值为 false，则最先返回最近的日志事件。（默认值为 false。）

--start-time START_TIME

指定时间范围的开始时间，以 ISO 8601 格式（YYYY-MM-DDThh:mm:ssZ，例如 2021-01-01T20:00:00Z）表示。包括时间戳等于或晚于该时间的事件。

使用 AWS ParallelCluster 版本 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"
    }
  ]
}