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

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

Amazon S3 버킷을 통과하여 이미지 빌더 스택의 로그를 로컬 `tar.gz` 아카이브로 내보냅니다.

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

**참고**  
`export-image-logs` 명령은 CloudWatch Logs가 로그 내보내기를 완료할 때까지 대기하므로 출력 없이 일정 시간이 걸릴 것으로 예상됩니다.

## 이름 지정된 인수
<a name="pcluster-v3.export-image-logs.namedargs"></a>

**-h, --help**  
`pcluster export-image-logs`에 대한 도움말 텍스트를 표시합니다.

**--bucket *BUCKET\$1NAME***  
이미지 빌드 로그를 내보낼 Amazon S3 버킷 이름을 지정합니다. 그것은 이미지와 같은 리전에 있어야 합니다.  
+ CloudWatch 액세스 권한을 부여하려면 Amazon S3 버킷 정책에 권한을 추가해야 합니다. 자세한 내용은 CloudWatch Logs 사용 설명서의 [ Amazon S3 버킷에 대한 권한 설정을](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) 참조하세요. *CloudWatch *
+  AWS ParallelCluster 버전 **3.12.0**부터 `--bucket` 옵션은 **선택 사항**입니다. 옵션을 지정하지 않으면 리전 기본 버킷(`parallelcluster-hash-v1-DO-NOT-DELETE`)이 AWS ParallelCluster 사용되거나 `CustomS3Bucket`가 이미지 구성에 지정된 경우 해당 버킷이 사용됩니다.
 AWS ParallelCluster 기본 버킷을 사용하는 경우 pcluster가 버킷 정책을 구성합니다. AWS ParallelCluster 버전 **3.12.0**으로 업그레이드하기 전에 버킷 정책을 사용자 지정하면 버킷 정책이 재정의되므로 변경 사항을 다시 적용해야 합니다.

**--image-id, -i *IMAGE\$1ID***  
로그를 내보낼 이미지 ID입니다.

**--bucket-prefix *BUCKET\$1PREFIX***  
내보낸 로그 데이터가 저장되는 Amazon S3 버킷의 경로를 지정합니다.  
기본적으로 버킷 접두사는 다음과 같습니다.  

```
ami-id-logs-202209061743.tar.gz
```
`202209061743`는 현재 시간을 `%Y%m%d%H%M` 형식으로 나타낸 것입니다.  
 AWS ParallelCluster 버전 **3.12.0**부터는 `--bucket` 옵션을 지정하지 않고 기본 AWS ParallelCluster 버킷을 사용하는 경우 내부용으로 예약된 보호`parallelcluster/`된 폴더이므로 폴더로 로그를 내보낼 수 없습니다.

**--debug**  
디버깅 로깅을 활성화합니다.

**--end-time *END\$1TIME***  
로그 이벤트를 수집할 시간 범위의 끝을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`‘)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다. 시간 요소(예: 분 및 초)는 생략될 수 있습니다. 기본값은 현재 시간입니다.

**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***  
`true`면 내보낸 객체를 아마존 S3로 내보낸 것을 보관합니다. (`false`로 디폴트됩니다.)

**--output-file *OUTPUT\$1FILE***  
로그 아카이브를 저장할 파일 경로를 지정합니다. 이 정보가 제공되면 로그가 로컬에 저장됩니다. 그렇지 않으면 출력에 반환된 URL과 함께 Amazon S3에 업로드됩니다. Amazon S3로 업로드하는 것이 기본값입니다.

**--region, -r *REGION***  
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.

**--start-time *START\$1TIME***  
시간 범위의 시작을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 로그 이벤트가 포함됩니다. 지정하지 않을 경우 기본값은 클러스터가 생성된 시간입니다.

** AWS ParallelCluster 버전 3.1.4 사용 예제:**

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