기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# getImageLogEvents
<a name="get-image-log-events"></a>

이미지 빌드와 관련된 이벤트를 검색합니다.

**Topics**
+ [요청 구문](#get-image-log-events-request)
+ [요청 본문](#get-image-log-events-request-body)
+ [응답 구문](#get-image-log-events-response)
+ [응답 본문](#get-image-log-events-response-body)
+ [예제](#get-image-log-events-example)

## 요청 구문
<a name="get-image-log-events-request"></a>

```
GET /v3/images/custom/{imageId}/logstreams/{logStreamName}
{
  "endTime": datetime,
  "limit": float,
  "nextToken": "string",
  "region": "string",
  "startFromHead": boolean,
  "startTime": datetime
}
```

## 요청 본문
<a name="get-image-log-events-request-body"></a>

**imageId**  
이미지의 ID입니다.  
유형: string  
필수 항목 여부: 예

**logStreamName**  
로그스트림의 이름입니다.  
유형: string  
필수 항목 여부: 예

**endTime**  
시간 범위의 끝입니다. ISO 8601 형식으로 표시됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다.  
유형: 날짜/시간  
형식: `2021-01-01T20:00:00Z`  
필수 여부: 아니요

**제한**  
반환된 로그 이벤트의 최대 수입니다. 값을 지정하지 않는 경우 최대값은 1MB의 응답 크기에 들어갈 수 있는 로그 이벤트 수(최대 10,000개의 로그 이벤트)입니다.  
유형: float  
필수 여부: 아니요

**nextToken**  
다음 결과 집합에 대한 토큰입니다.  
유형: string  
필수 항목 여부: 아니요

**region**  
이미지가 AWS 리전 있는 입니다.  
유형: string  
필수 항목 여부: 아니요

**startFromHead**  
`true`로 설정된 경우 가장 이른 로그 이벤트를 먼저 반환합니다. false로 설정되어 있는 경우에는 최신 로그 이벤트를 먼저 반환합니다. 기본값은 `false`입니다.  
유형: boolean  
필수 항목 여부: 아니요

**startTime**  
시간 범위의 시작입니다. ISO 8601 형식으로 표시됩니다. 타임스탬프가 이 시간 이후인 이벤트가 포함됩니다.  
유형: 날짜/시간  
형식: `2021-01-01T20:00:00Z`  
필수 항목 여부: 아니요

## 응답 구문
<a name="get-image-log-events-response"></a>

```
{
  "nextToken": "string",
  "prevToken": "string",
  "events": [
    {
      "timestamp": "2019-08-24T14:15:22Z",
      "message": "string"
    }
  ]
}
```

## 응답 본문
<a name="get-image-log-events-response-body"></a>

**events**  
필터링된 이벤트 목록입니다.    
**message**  
이벤트 메시지  
유형: string  
**타임스탬프**  
이벤트 타임스탬프입니다.  
유형: 날짜/시간

**nextToken**  
다음 결과 집합을 가져오기 위해 사용할 수 있는 토큰이지만 결과가 더 이상 없는 경우에는 `null`입니다.  
유형: string

**prevToken**  
이전 결과 세트를 검색하거나 추가 결과가 없는 `null` 경우 사용할 수 있는 토큰입니다.  
유형: string

## 예제
<a name="get-image-log-events-example"></a>

------
#### [ Python ]

**요청**

```
$ get_image_log_events(image_id, log_stream_name=3.2.1/1)
```

**200 응답**

```
"events": [
  {
    "message": "ExecuteBash: STARTED EXECUTION",
    "timestamp": 2022-04-05T15:51:20.228Z"
  },
  {
    "message": "ExecuteBash: Created temporary directory: /tmp/1234567890abcdef0",
    "timestamp": "2022-04-05T15:51:20.228Z"
  },
  ...
]
```

------