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

# Amazon EMR에서 오류 코드 및 ErrorDetail 정보
<a name="emr-troubleshoot-error-errordetail"></a>

EMR 클러스터가 오류와 함께 종료되면 `DescribeCluster` 및 `ListClusters` API는 오류 코드와 오류 메시지를 반환합니다. 일부 클러스터 오류의 경우 `ErrorDetail` 데이터 배열이 장애 문제를 해결하는 데 도움이 될 수 있습니다.

`ErrorDetail` 배열이 포함된 오류는 다음과 같은 세부 정보를 제공합니다.

**`ErrorCode`**  
프로그래밍 방식의 액세스에 사용할 수 있는 고유한 오류 코드.

**`ErrorData`**  
프로그래밍 방식의 검색 또는 수동 검색에 사용할 수 있는 키-값 페어의 식별자 목록. 오류 코드에 포함된 `ErrorData` 값에 대한 설명은 오류 코드의 문제 해결 페이지를 참조하세요.

**`ErrorMessage`**  
오류에 대한 설명과 Amazon EMR 설명서의 추가 정보 링크.  
이 텍스트는 변경될 수 있으므로 `ErrorMessage`에서 텍스트를 구문 분석하지 않는 것이 좋습니다.

**Topics**
+ [부트스트랩 실패](emr-troubleshoot-error-errordetail-bootstrap.md)
+ [내부 오류.](emr-troubleshoot-error-errordetail-internal.md)
+ [검증 실패](emr-troubleshoot-error-errordetail-validation.md)

# Amazon EMR에서의 부트스트랩 실패 오류 코드
<a name="emr-troubleshoot-error-errordetail-bootstrap"></a>

다음 섹션에서는 부트스트랩 실패 오류 코드에 대한 문제 해결 정보를 제공합니다.

**Topics**
+ [BOOTSTRAP\$1FAILURE\$1PRIMARY\$1WITH\$1NON\$1ZERO\$1CODE](BOOTSTRAP_FAILURE_PRIMARY_WITH_NON_ZERO_CODE.md)
+ [BOOTSTRAP\$1FAILURE\$1BA\$1DOWNLOAD\$1FAILED\$1PRIMARY](BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY.md)
+ [BOOTSTRAP\$1FAILURE\$1FILE\$1NOT\$1FOUND\$1PRIMARY](BOOTSTRAP_FAILURE_FILE_NOT_FOUND_PRIMARY.md)
+ [BOOTSTRAP\$1FAILURE\$1INSUFFICIENT\$1DISK\$1SPACE\$1PRIMARY](BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_PRIMARY.md)
+ [BOOTSTRAP\$1FAILURE\$1INSUFFICIENT\$1DISK\$1SPACE\$1WORKER](BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_WORKER.md)
+ [BOOTSTRAP\$1FAILURE\$1HIVE\$1METASTORE\$1CONNECTION\$1ERROR\$1PRIMARY](BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_PRIMARY.md)
+ [BOOTSTRAP\$1FAILURE\$1HIVE\$1METASTORE\$1CONNECTION\$1ERROR\$1WORKER](BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_WORKER.md)

# BOOTSTRAP\$1FAILURE\$1PRIMARY\$1WITH\$1NON\$1ZERO\$1CODE
<a name="BOOTSTRAP_FAILURE_PRIMARY_WITH_NON_ZERO_CODE"></a>

## 개요
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_WITH_NON_ZERO_CODE_overview"></a>

클러스터가 `BOOTSTRAP_FAILURE_PRIMARY_WITH_NON_ZERO_CODE` 오류로 종료되면 기본 인스턴스에서 부트스트랩 작업이 실패한 것입니다. 부트스트랩 작업에 대한 자세한 내용은 [부트스트랩 작업을 생성하여 Amazon EMR 클러스터에서 추가 소프트웨어 설치](emr-plan-bootstrap.md) 섹션을 참조하세요.

## 해결 방법
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_WITH_NON_ZERO_CODE_resolution"></a>

이 오류를 해결하려면 API 오류에 반환된 세부 정보를 검토하고, 부트스트랩 작업 스크립트를 수정하며, 업데이트된 부트스트랩 작업으로 새 클러스터를 생성합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`primary-instance-id`**  
부트스트랩 작업이 실패한 기본 인스턴스의 ID.

**`bootstrap-action`**  
실패한 부트스트랩 작업의 서수. `bootstrap-action` 값이 `1`인 스크립트가 인스턴스에서 실행하는 첫 번째 부트스트랩 작업입니다.

**`return-code`**  
실패한 부트스트랩 작업의 반환 코드.

**`amazon-s3-path`**  
실패한 부트스트랩 작업의 Amazon S3 위치.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_WITH_NON_ZERO_CODE_stc"></a>

다음 단계를 수행하여 부트스트랩 작업 오류의 근본 원인을 식별하고 수정합니다. 그런 다음, 새 클러스터를 시작합니다.

1. Amazon S3의 부트스트랩 작업 로그 파일을 검토하여 실패의 근본 원인을 식별합니다. Amazon EMR 로그를 보는 방법에 대한 자세한 내용은 [Amazon EMR 로그 파일 보기](emr-manage-view-web-log-files.md) 섹션을 참조하세요.

1. 인스턴스를 생성할 때 클러스터 로그를 활성화한 경우 자세한 내용은 `stdout` 로그를 참조하세요. 부트스트랩 작업에 대한 `stdout` 로그는 다음 Amazon S3 위치에서 찾을 수 있습니다.

   ```
   s3://amzn-s3-demo-bucket/logs/Your_Cluster_Id/node/Primary_Instance_Id/bootstrap-actions/Failed_Bootstrap_Action_Number/stdout.gz 
   ```

   클러스터 로그에 대한 자세한 내용은 [Amazon EMR 클러스터 로깅 및 디버깅 구성](emr-plan-debugging.md) 섹션을 참조하세요.

1. 부트스트랩 작업 실패를 확인하려면 `stdout` 로그의 예외와 `ErrorData`의 `return-code` 값을 검토합니다.

1. 이전 단계에서 찾은 조사 결과를 사용하여 예외를 방지하거나 예외 발생 시 적절하게 처리할 수 있도록 부트스트랩 작업을 수정합니다.

1. 업데이트된 부트스트랩 작업으로 새 클러스터를 시작합니다.

# BOOTSTRAP\$1FAILURE\$1BA\$1DOWNLOAD\$1FAILED\$1PRIMARY
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY"></a>

## 개요
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY_overview"></a>

기본 인스턴스가 지정한 Amazon S3 위치에서 부트스트랩 작업 스크립트를 다운로드할 수 없는 경우 클러스터는 `BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY` 오류로 종료됩니다. 잠재적 원인은 다음과 같습니다.
+ 부트스트랩 작업 스크립트 파일이 지정된 Amazon S3 위치에 없습니다.
+ 클러스터의 Amazon EC2 인스턴스에 대한 서비스 역할(*Amazon EMR의 EC2 인스턴스 프로파일*이라고도 함)에 부트스트랩 작업 스크립트가 있는 Amazon S3 버킷에 액세스할 권한이 없습니다. 서비스 역할에 대한 자세한 내용은 [클러스터 EC2 인스턴스에 대한 서비스 역할(EC2 인스턴스 프로파일)](emr-iam-role-for-ec2.md)을 참조하세요.

부트스트랩 작업에 대한 자세한 내용은 [부트스트랩 작업을 생성하여 Amazon EMR 클러스터에서 추가 소프트웨어 설치](emr-plan-bootstrap.md) 섹션을 참조하세요.

## 해결 방법
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY_resolution"></a>

이 오류를 해결하려면 기본 인스턴스에 부트스트랩 작업 스크립트에 대한 적절한 액세스 권한이 있어야 합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`primary-instance-id`**  
부트스트랩 작업이 실패한 기본 인스턴스의 ID.

**`bootstrap-action`**  
실패한 부트스트랩 작업의 서수. `bootstrap-action` 값이 `1`인 스크립트가 인스턴스에서 실행하는 첫 번째 부트스트랩 작업입니다.

**`amazon-s3-path`**  
실패한 부트스트랩 작업의 Amazon S3 위치.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY_stc"></a>

다음 단계를 수행하여 부트스트랩 작업 오류의 근본 원인을 식별하고 수정합니다. 그런 다음, 새 클러스터를 시작합니다.

**문제 해결 단계**

1. `ErrorData` 배열의 `amazon-s3-path` 값을 사용하여 Amazon S3에서 관련 부트스트랩 작업 스크립트를 찾습니다.

1. 인스턴스를 생성할 때 클러스터 로그를 활성화한 경우 자세한 내용은 `stdout` 로그를 참조하세요. 부트스트랩 작업에 대한 `stdout` 로그는 다음 Amazon S3 위치에서 찾을 수 있습니다.

   ```
   s3://amzn-s3-demo-bucket/logs/Your_Cluster_Id/node/Primary_Instance_Id/bootstrap-actions/Failed_Bootstrap_Action_Number/stdout.gz 
   ```

   클러스터 로그에 대한 자세한 내용은 [Amazon EMR 클러스터 로깅 및 디버깅 구성](emr-plan-debugging.md) 섹션을 참조하세요.

1. 부트스트랩 작업 실패를 확인하려면 `stdout` 로그의 예외와 `ErrorData`의 `return-code` 값을 검토합니다.

1. 이전 단계에서 찾은 조사 결과를 사용하여 예외를 방지하거나 예외 발생 시 적절하게 처리할 수 있도록 부트스트랩 작업을 수정합니다.

1. 업데이트된 부트스트랩 작업으로 새 클러스터를 시작합니다.

# BOOTSTRAP\$1FAILURE\$1FILE\$1NOT\$1FOUND\$1PRIMARY
<a name="BOOTSTRAP_FAILURE_FILE_NOT_FOUND_PRIMARY"></a>

## 개요
<a name="BOOTSTRAP_FAILURE_FILE_NOT_FOUND_PRIMARY_overview"></a>

이 `BOOTSTRAP_FAILURE_FILE_NOT_FOUND_PRIMARY` 오류는 인스턴스가 지정된 Amazon S3 버킷에서 방금 다운로드한 부트스트랩 작업 스크립트를 기본 인스턴스에서 찾을 수 없음을 나타냅니다.

## 해결 방법
<a name="BOOTSTRAP_FAILURE_FILE_NOT_FOUND_PRIMARY_resolution"></a>

이 오류를 해결하려면 기본 인스턴스에 부트스트랩 작업 스크립트에 대한 적절한 액세스 권한이 있는지 확인합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`primary-instance-id`**  
부트스트랩 작업이 실패한 기본 인스턴스의 ID.

**`bootstrap-action`**  
실패한 부트스트랩 작업의 서수. `bootstrap-action` 값이 `1`인 스크립트가 인스턴스에서 실행하는 첫 번째 부트스트랩 작업입니다.

**`amazon-s3-path`**  
실패한 부트스트랩 작업의 Amazon S3 위치.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="BOOTSTRAP_FAILURE_FILE_NOT_FOUND_PRIMARY_stc"></a>

다음 단계를 수행하여 부트스트랩 작업 오류의 근본 원인을 식별하고 수정합니다. 그런 다음, 새 클러스터를 시작합니다.

1. Amazon S3에서 관련 부트스트랩 작업 스크립트를 찾으려면 `ErrorData` 배열의 `amazon-s3-path` 값을 사용합니다.

1. Amazon S3의 부트스트랩 작업 로그 파일을 검토하여 실패의 근본 원인을 식별합니다. Amazon EMR 로그를 보는 방법에 대한 자세한 내용은 [Amazon EMR 로그 파일 보기](emr-manage-view-web-log-files.md) 섹션을 참조하세요.
**참고**  
클러스터의 로그를 켜지 않은 경우 동일한 구성과 부트스트랩 작업을 사용하여 새 클러스터를 생성해야 합니다. 클러스터 로그가 켜져 있는지 확인하려면 [Amazon EMR 클러스터 로깅 및 디버깅 구성](emr-plan-debugging.md) 섹션을 참조하세요.

1. `stdout` 로그에서 부트스트랩 작업을 검토하고 기본 인스턴스의 `/emr/instance-controller/lib/bootstrap-actions` 폴더에 있는 파일을 삭제하는 사용자 지정 프로세스가 없는지 확인합니다. 부트스트랩 작업에 대한 `stdout` 로그는 다음 Amazon S3 위치에서 찾을 수 있습니다.

   ```
   s3://amzn-s3-demo-bucket/logs/Your_Cluster_Id/node/Primary_Instance_Id/bootstrap-actions/Failed_Bootstrap_Action_Number/stdout.gz
   ```

1. 업데이트된 부트스트랩 작업으로 새 클러스터를 시작합니다.

# BOOTSTRAP\$1FAILURE\$1INSUFFICIENT\$1DISK\$1SPACE\$1PRIMARY
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_PRIMARY"></a>

## 개요
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_PRIMARY_overview"></a>

 `BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_PRIMARY` 오류는 필요한 소프트웨어를 설치할 때 기본 인스턴스에 충분한 디스크 공간이 없음을 나타냅니다.

## 해결 방법
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_PRIMARY_resolution"></a>

 이 오류를 해결하려면 기본 인스턴스에 루트 볼륨에 충분한 디스크 공간이 있어야 합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`primary-instance-id`**  
디스크 공간이 부족한 기본 인스턴스의 ID입니다.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_PRIMARY_stc"></a>

1.  클러스터의 EBS 루트 디바이스 볼륨에 대한 모범 사례를 검토합니다. *Amazon EMR 관리 안내서*에서 [Amazon EBS 루트 디바이스 볼륨 사용자 지정](emr-custom-ami-root-volume-size.md) 섹션을 참조하세요.

1. EBS 루트 디바이스 볼륨 크기가 더 큰 새 클러스터를 시작합니다.

# BOOTSTRAP\$1FAILURE\$1INSUFFICIENT\$1DISK\$1SPACE\$1WORKER
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_WORKER"></a>

## 개요
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_WORKER_overview"></a>

 `BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_WORKER` 오류는 필요한 소프트웨어를 설치할 때 하나 이상의 워커 인스턴스에 충분한 디스크 공간이 없음을 나타냅니다.

## 해결 방법
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_WORKER_resolution"></a>

 이 오류를 해결하려면 루트 볼륨에 워커 인스턴스의 디스크 공간이 충분한지 확인합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`worker-instance-ids`**  
디스크 공간이 부족한 워커 인스턴스의 ID입니다.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="BOOTSTRAP_FAILURE_INSUFFICIENT_DISK_SPACE_WORKER_stc"></a>

1.  클러스터의 EBS 루트 디바이스 볼륨에 대한 모범 사례를 검토합니다. *Amazon EMR 관리 안내서*에서 [Amazon EBS 루트 디바이스 볼륨 사용자 지정](emr-custom-ami-root-volume-size.md) 섹션을 참조하세요.

1. EBS 루트 디바이스 볼륨 크기가 더 큰 새 클러스터를 시작합니다.

# BOOTSTRAP\$1FAILURE\$1HIVE\$1METASTORE\$1CONNECTION\$1ERROR\$1PRIMARY
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_PRIMARY"></a>

## 개요
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_PRIMARY_overview"></a>

 `BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_PRIMARY` 오류는 기본 인스턴스가 구성된 외부 Hive 메타스토어에 대한 연결을 설정할 수 없음을 나타냅니다.

## 해결 방법
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_PRIMARY_resolution"></a>

 이 오류를 해결하려면 외부 Hive 메타스토어가 올바르게 구성되어 있고 기본 인스턴스가 이 메타스토어에 연결할 수 있는지 확인합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`primary-instance-id`**  
구성된 외부 Hive 메타스토어에 대한 연결을 설정할 수 없는 기본 인스턴스의 ID입니다.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_PRIMARY_stc"></a>

1.  Hive용 외부 메타스토어를 구성하기 위한 모범 사례를 검토합니다. [Hive용 외부 메타스토어 구성](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-metastore-external-hive.html)을 참조하세요.

1. 업데이트된 클러스터 구성으로 새 클러스터를 시작합니다.

# BOOTSTRAP\$1FAILURE\$1HIVE\$1METASTORE\$1CONNECTION\$1ERROR\$1WORKER
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_WORKER"></a>

## 개요
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_WORKER_overview"></a>

 `BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_WORKER` 오류는 하나 이상의 워커 인스턴스가 구성된 외부 Hive 메타스토어에 대한 연결을 설정할 수 없음을 나타냅니다.

## 해결 방법
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_WORKER_resolution"></a>

 이 오류를 해결하려면 외부 Hive 메타스토어가 올바르게 구성되어 있고 워커 인스턴스가 이 메타스토어에 연결할 수 있는지 확인합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`worker-instance-ids`**  
구성된 외부 Hive 메타스토어에 대한 연결을 설정할 수 없는 워커 인스턴스의 IDs.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="BOOTSTRAP_FAILURE_HIVE_METASTORE_CONNECTION_ERROR_WORKER_stc"></a>

1.  Hive용 외부 메타스토어를 구성하기 위한 모범 사례를 검토합니다. [Hive용 외부 메타스토어 구성](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-metastore-external-hive.html)을 참조하세요.

1. 업데이트된 클러스터 구성으로 새 클러스터를 시작합니다.

# Amazon EMR의 내부 오류 코드
<a name="emr-troubleshoot-error-errordetail-internal"></a>

다음 섹션에서는 용량 없음 또는 용량 부족에 대한 코드를 포함하여 내부 오류 코드에 대한 문제 해결 정보를 제공합니다.

**Topics**
+ [INTERNAL\$1ERROR\$1EC2\$1INSUFFICIENT\$1CAPACITY\$1AZ](INTERNAL_ERROR_EC2_INSUFFICIENT_CAPACITY_AZ.md)
+ [INTERNAL\$1ERROR\$1SPOT\$1PRICE\$1INCREASE\$1PRIMARY](INTERNAL_ERROR_SPOT_PRICE_INCREASE_PRIMARY.md)
+ [INTERNAL\$1ERROR\$1SPOT\$1NO\$1CAPACITY\$1PRIMARY](INTERNAL_ERROR_SPOT_NO_CAPACITY_PRIMARY.md)

# INTERNAL\$1ERROR\$1EC2\$1INSUFFICIENT\$1CAPACITY\$1AZ
<a name="INTERNAL_ERROR_EC2_INSUFFICIENT_CAPACITY_AZ"></a>

## 개요
<a name="INTERNAL_ERROR_EC2_INSUFFICIENT_CAPACITY_AZ_overview"></a>

선택한 가용 영역에 Amazon EC2 인스턴스 유형 요청을 처리할 충분한 용량이 없을 경우 클러스터가 `INTERNAL_ERROR_EC2_INSUFFICIENT_CAPACITY_AZ` 오류로 종료됩니다. 클러스터에 대해 선택한 서브넷에 따라 가용 영역이 결정됩니다. Amazon EMR의 서브넷에 대한 자세한 내용은 [Amazon EMR에 대해 VPC에서 네트워킹 구성](emr-plan-vpc-subnet.md) 섹션을 참조하세요.

## 해결 방법
<a name="INTERNAL_ERROR_EC2_INSUFFICIENT_CAPACITY_AZ_resolution"></a>

이 오류를 해결하려면 인스턴스 유형 구성을 수정하고 업데이트된 요청으로 새 클러스터를 생성합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`instance-type`**  
용량이 부족한 인스턴스 유형.

**`availability-zone`**  
서브넷이 확인하는 가용 영역.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="INTERNAL_ERROR_EC2_INSUFFICIENT_CAPACITY_AZ_stc"></a>

다음 단계를 수행하여 클러스터 구성 오류의 근본 원인을 식별하고 수정합니다.
+ 클러스터 구성에 대한 모범 사례를 검토합니다. *Amazon EMR 관리 안내서*에서 [스팟 인스턴스에 대한 Amazon EMR 클러스터 인스턴스 유형 및 모범 사례 구성](emr-plan-instances-guidelines.md) 섹션을 참조하세요.
+ 시작 문제를 해결하고 구성을 검토합니다. **Amazon EC2 사용 설명서에서 [인스턴스 시작 문제 해결](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/troubleshooting-launch.html)을 참조하세요.
+ 업데이트된 클러스터 구성으로 새 클러스터를 시작합니다.

# INTERNAL\$1ERROR\$1SPOT\$1PRICE\$1INCREASE\$1PRIMARY
<a name="INTERNAL_ERROR_SPOT_PRICE_INCREASE_PRIMARY"></a>

## 개요
<a name="INTERNAL_ERROR_SPOT_PRICE_INCREASE_PRIMARY_overview"></a>

인스턴스를 최고 스팟 가격 이하로 사용할 수 없으므로 Amazon EMR이 프라이머리 노드에 대한 스팟 인스턴스 요청을 이행할 수 없는 경우 클러스터가 종료되고 `INTERNAL_ERROR_SPOT_PRICE_INCREASE_PRIMARY` 오류가 발생합니다. 자세한 내용은 *Amazon EC2 사용 설명서*의 [스팟 인스턴스](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html)를 참조하세요.

## 해결 방법
<a name="INTERNAL_ERROR_SPOT_PRICE_INCREASE_PRIMARY_resolution"></a>

이 오류를 해결하려면 가격 목표 범위 내에 있는 클러스터의 인스턴스 유형을 지정하거나 동일한 인스턴스 유형에 대한 가격 한도를 높입니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`primary-instance-id`**  
실패한 클러스터의 기본 인스턴스 ID.

**`instance-type`**  
용량이 부족한 인스턴스 유형.

**`availability-zone`**  
서브넷이 있는 가용 영역.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="INTERNAL_ERROR_SPOT_PRICE_INCREASE_PRIMARY_stc"></a>

다음 단계를 수행하여 클러스터 구성 전략의 문제를 해결한 후 새 클러스터를 시작합니다.

1. Amazon EC2 스팟 인스턴스의 모범 사례를 검토하고 클러스터 구성 전략을 검토합니다. 자세한 내용은 [스팟 인스턴스에 대한 Amazon EMR 클러스터 인스턴스 유형 및 모범 사례 구성](emr-plan-instances-guidelines.md) 섹션 및 *Amazon EC2 사용 설명서*에서 [EC2 스팟 모범 사례](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-best-practices.html)를 참조하세요.

1. 인스턴스 유형 구성 또는 가용 영역을 수정하고 업데이트된 요청으로 새 클러스터를 생성합니다.

1. 문제가 지속되면 기본 인스턴스의 온디맨드 용량을 사용합니다.

# INTERNAL\$1ERROR\$1SPOT\$1NO\$1CAPACITY\$1PRIMARY
<a name="INTERNAL_ERROR_SPOT_NO_CAPACITY_PRIMARY"></a>

## 개요
<a name="INTERNAL_ERROR_SPOT_NO_CAPACITY_PRIMARY_overview"></a>

프라이머리 노드에 대한 스팟 인스턴스 요청을 처리할 용량이 충분하지 않으면 클러스터가 `INTERNAL_ERROR_SPOT_NO_CAPACITY_PRIMARY` 오류와 함께 종료됩니다. 자세한 내용은 *Amazon EC2 사용 설명서*의 [스팟 인스턴스](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html)를 참조하세요.

## 해결 방법
<a name="INTERNAL_ERROR_SPOT_NO_CAPACITY_PRIMARY_resolution"></a>

이 오류를 해결하려면 가격 목표 범위 내에 있는 클러스터의 인스턴스 유형을 지정하거나 동일한 인스턴스 유형에 대한 가격 한도를 높입니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`primary-instance-id`**  
실패한 클러스터의 기본 인스턴스 ID.

**`instance-type`**  
용량이 부족한 인스턴스 유형.

**`availability-zone`**  
서브넷이 확인하는 가용 영역.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="INTERNAL_ERROR_SPOT_NO_CAPACITY_PRIMARY_stc"></a>

다음 단계를 수행하여 클러스터 구성 전략의 문제를 해결한 후 새 클러스터를 시작합니다.

1. Amazon EC2 스팟 인스턴스의 모범 사례를 검토하고 클러스터 구성 전략을 검토합니다. 자세한 내용은 [스팟 인스턴스에 대한 Amazon EMR 클러스터 인스턴스 유형 및 모범 사례 구성](emr-plan-instances-guidelines.md) 섹션 및 *Amazon EC2 사용 설명서*에서 [EC2 스팟 모범 사례](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-best-practices.html)를 참조하세요.

1. 인스턴스 유형 구성을 수정하고 업데이트된 요청으로 새 클러스터를 생성합니다.

1. 문제가 지속되면 기본 인스턴스의 온디맨드 용량을 사용합니다.

# Amazon EMR에서의 검증 실패 오류 코드
<a name="emr-troubleshoot-error-errordetail-validation"></a>

다음 섹션에서는 검증 실패 오류 코드에 대한 문제 해결 정보를 제공합니다.

**Topics**
+ [VALIDATION\$1ERROR\$1SUBNET\$1NOT\$1FROM\$1ONE\$1VPC](VALIDATION_ERROR_SUBNET_NOT_FROM_ONE_VPC.md)
+ [VALIDATION\$1ERROR\$1SECURITY\$1GROUP\$1NOT\$1FROM\$1ONE\$1VPC](VALIDATION_ERROR_SECURITY_GROUP_NOT_FROM_ONE_VPC.md)
+ [VALIDATION\$1ERROR\$1INVALID\$1SSH\$1KEY\$1NAME](VALIDATION_ERROR_INVALID_SSH_KEY_NAME.md)
+ [VALIDATION\$1ERROR\$1INSTANCE\$1TYPE\$1NOT\$1SUPPORTED](VALIDATION_ERROR_INSTANCE_TYPE_NOT_SUPPORTED.md)

# VALIDATION\$1ERROR\$1SUBNET\$1NOT\$1FROM\$1ONE\$1VPC
<a name="VALIDATION_ERROR_SUBNET_NOT_FROM_ONE_VPC"></a>

## 개요
<a name="VALIDATION_ERROR_SUBNET_NOT_FROM_ONE_VPC_overview"></a>

클러스터 및 클러스터에서 참조하는 서브넷이 서로 다른 Virtual Private Cloud(VPC)에 속하는 경우 클러스터는 `VALIDATION_ERROR_SUBNET_NOT_FROM_ONE_VPC` 오류로 종료됩니다. VPC의 서브넷에서 인스턴스 플릿 구성을 포함하는 Amazon EMR에서 클러스터를 시작할 수 있습니다. 인스턴스 플릿에 대한 자세한 내용은 *Amazon EMR 관리 안내서*에서 [Amazon EMR 클러스터의 인스턴스 플릿 계획 및 구성](emr-instance-fleet.md) 섹션을 참조하세요.

## 해결 방법
<a name="VALIDATION_ERROR_SUBNET_NOT_FROM_ONE_VPC_resolution"></a>

이 오류를 해결하려면 클러스터와 동일한 VPC에 속한 서브넷을 사용합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`vpc`**  
각 subnet:VPC 페어에서 서브넷이 속한 VPC의 ID.

**`subnet`**  
각 subnet:VPC 페어에서 서브넷의 ID.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="VALIDATION_ERROR_SUBNET_NOT_FROM_ONE_VPC_stc"></a>

오류를 식별하고 수정하려면 다음 단계를 수행합니다.

1. `ErrorData` 배열에 나열된 서브넷 ID를 검토하고 EMR 클러스터를 시작하려는 VPC에 속해 있는지 확인합니다.

1. 서브넷 구성을 수정합니다. 다음 방법 중 하나를 사용하여 VPC에서 사용 가능한 모든 퍼블릭 및 프라이빗 서브넷을 찾을 수 있습니다.
   + Amazon VPC 콘솔로 이동합니다. **서브넷을** 선택하고 클러스터의 내에 있는 모든 서브넷 AWS 리전 을 나열합니다. 퍼블릭 또는 프라이빗 서브넷만 찾으려면 **퍼블릭 IPv4 주소 자동 할당** 필터를 적용합니다. 클러스터가 사용하는 VPC에서 서브넷을 찾아 선택하려면 **VPC별 필터링** 옵션을 사용합니다. 서브넷을 생성하는 방법에 대한 자세한 내용은 *Amazon Virtual Private Cloud 사용 설명서*에서 [서브넷 생성](https://docs.aws.amazon.com/vpc/latest/userguide/create-subnets.html)을 참조하세요.
   +  AWS CLI 를 사용하여 클러스터에서 사용하는 VPC에서 사용 가능한 모든 퍼블릭 및 프라이빗 서브넷을 찾습니다. 자세한 내용은 [describe-subnets](https://amazonaws.com/ec2/describe-subnets.html) API를 참조하세요. VPC에서 새 서브넷을 생성하려면 [create-subnet](https://amazonaws.com/ec2/create-subnet.html) API를 참조하세요.

1. 클러스터와 동일한 VPC의 서브넷을 사용하여 새 클러스터를 시작합니다.

# VALIDATION\$1ERROR\$1SECURITY\$1GROUP\$1NOT\$1FROM\$1ONE\$1VPC
<a name="VALIDATION_ERROR_SECURITY_GROUP_NOT_FROM_ONE_VPC"></a>

## 개요
<a name="VALIDATION_ERROR_SECURITY_GROUP_NOT_FROM_ONE_VPC_overview"></a>

클러스터 및 클러스터에 할당하는 보안 그룹이 서로 다른 Virtual Private Cloud(VPC)에 속하는 경우 클러스터는 `VALIDATION_ERROR_SECURITY_GROUP_NOT_FROM_ONE_VPC` 오류로 종료됩니다. 보안 그룹에 대한 자세한 내용은 [Amazon EMR 관리형 및 추가 보안 그룹 지정](emr-sg-specify.md) 및 [Amazon EMR 클러스터의 보안 그룹으로 네트워크 트래픽 제어](emr-security-groups.md) 섹션을 참조하세요.

## 해결 방법
<a name="VALIDATION_ERROR_SECURITY_GROUP_NOT_FROM_ONE_VPC_resolution"></a>

이 오류를 해결하려면 클러스터와 동일한 VPC에 속한 보안 그룹을 사용합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`vpc`**  
각 security-group:VPC 페어에서 보안 그룹이 속한 VPC의 ID.

**`security-group`**  
각 security-group:VPC 페어에서 보안 그룹 ID.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="VALIDATION_ERROR_SECURITY_GROUP_NOT_FROM_ONE_VPC_stc"></a>

오류를 식별하고 수정하려면 다음 단계를 수행합니다.

1. `ErrorData` 배열에 나열된 보안 그룹 ID를 검토하고 EMR 클러스터를 시작하려는 VPC에 속해 있는지 확인합니다.

1. Amazon VPC 콘솔로 이동합니다. **보안 그룹**을 선택하면 선택한 리전 내 모든 보안 그룹이 나열됩니다. 클러스터와 동일한 VPC에서 보안 그룹을 찾고 보안 그룹 구성을 수정합니다.

1. 클러스터와 동일한 VPC의 보안 그룹을 사용하여 새 클러스터를 시작합니다.

# VALIDATION\$1ERROR\$1INVALID\$1SSH\$1KEY\$1NAME
<a name="VALIDATION_ERROR_INVALID_SSH_KEY_NAME"></a>

## 개요
<a name="VALIDATION_ERROR_INVALID_SSH_KEY_NAME_overview"></a>

기본 인스턴스로의 SSH 연결에 유효하지 않은 Amazon EC2 키 페어를 사용하면 클러스터가 `VALIDATION_ERROR_INVALID_SSH_KEY_NAME` 오류로 종료됩니다. 키 페어 이름이 잘못되었거나 키 페어가 요청된에 존재하지 않을 수 있습니다 AWS 리전. 자세한 내용은 **Amazon EC2 사용 설명서에서 [Amazon EC2 키 페어 및 Linux 인스턴스](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html)를 참조하세요.

## 해결 방법
<a name="VALIDATION_ERROR_INVALID_SSH_KEY_NAME_resolution"></a>

이 오류를 해결하려면 유효한 SSH 키 페어 이름을 사용하여 새 클러스터를 생성합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`ssh-key`**  
클러스터를 생성할 때 제공한 SSH 키 페어 이름.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="VALIDATION_ERROR_INVALID_SSH_KEY_NAME_stc"></a>

오류를 식별하고 수정하려면 다음 단계를 수행합니다.

1. *keypair*.pem 파일을 확인하고 Amazon EMR 콘솔에 표시되는 SSH 키의 이름과 일치하는지 확인합니다.

1. Amazon EC2 콘솔로 이동합니다. 클러스터에서 사용하는에서 사용한 SSH 키 이름을 사용할 수 AWS 리전 있는지 확인합니다. 의 상단에서 계정 ID AWS 리전 옆에 있는를 찾을 수 있습니다 AWS Management Console.

1. 유효한 SSH 키 이름으로 새 클러스터를 시작합니다.

# VALIDATION\$1ERROR\$1INSTANCE\$1TYPE\$1NOT\$1SUPPORTED
<a name="VALIDATION_ERROR_INSTANCE_TYPE_NOT_SUPPORTED"></a>

## 개요
<a name="VALIDATION_ERROR_INSTANCE_TYPE_NOT_SUPPORTED_overview"></a>

클러스터의 AWS 리전 및 가용 영역이 하나 이상의 인스턴스 그룹에 지정된 인스턴스 유형을 지원하지 않으면 클러스터가 `VALIDATION_ERROR_INSTANCE_TYPE_NOT_SUPPORTED` 오류로 종료됩니다. Amazon EMR은 리전 내 한 가용 영역에서 인스턴스 유형을 지원하지만 다른 가용 영역에서는 지원하지 않을 수 있습니다. 클러스터에 대해 선택한 서브넷에 따라 리전 내 가용 영역이 결정됩니다. Amazon EMR에서 지원하는 인스턴스 유형 및 리전 목록은 [Amazon EMR에서 지원되는 인스턴스 유형](emr-supported-instance-types.md) 섹션을 참조하세요.

## 해결 방법
<a name="VALIDATION_ERROR_INSTANCE_TYPE_NOT_SUPPORTED_resolution"></a>

이 오류를 해결하려면 클러스터를 요청한 리전 및 가용 영역에서 Amazon EMR이 지원하는 클러스터의 인스턴스 유형을 지정합니다.

실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.

**`instance-types`**  
지원되지 않는 인스턴스 유형의 목록.

**`availability-zones`**  
서브넷이 확인하는 가용 영역 목록.

**`public-doc`**  
오류 코드에 대한 설명서의 퍼블릭 URL.

## 완료할 단계
<a name="VALIDATION_ERROR_INSTANCE_TYPE_NOT_SUPPORTED_stc"></a>

오류를 식별하고 수정하려면 다음 단계를 수행합니다.

1.  AWS CLI 를 사용하여 가용 영역에서 사용 가능한 인스턴스 유형을 검색합니다. 이렇게 하려면 `[ec2 describe-instance-type-offerings](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-type-offerings.html)` 명령을 사용하여 위치(AWS 리전 또는 가용 영역)별로 사용 가능한 인스턴스 유형을 필터링할 수 있습니다. 예를 들어, 다음 명령은 지정된 AZ, `us-east-2a`에서 제공되는 인스턴스 유형을 반환합니다.

   ```
   aws ec2 describe-instance-type-offerings --location-type "availability-zone" --filters Name=location,Values=us-east-2a --region us-east-2 --query "InstanceTypeOfferings[*].[InstanceType]" --output text | sort
   ```

   사용 가능한 인스턴스 유형을 찾는 방법에 대한 자세한 내용은 [Amazon EC2 인스턴스 유형 찾기](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-discovery.html)를 참조하세요.

1. 클러스터와 동일한 리전 및 가용 영역에서 사용할 수 있는 인스턴스 유형을 결정한 후 다음 해결 방법 중 하나를 선택하여 계속합니다.

   1. 새 클러스터를 생성하고, 선택한 인스턴스 유형이 Amazon EMR에서 지원하고 사용 가능한 가용 영역에서 클러스터의 서브넷을 선택합니다.

   1. 실패한 클러스터와 동일한 리전 및 Amazon EC2 서브넷에서 Amazon EMR이 해당 위치에서 지원하는 인스턴스 유형으로 새 클러스터를 생성합니다.

Amazon EMR에서 지원하는 인스턴스 유형 및 리전 목록은 [Amazon EMR에서 지원되는 인스턴스 유형](emr-supported-instance-types.md) 섹션을 참조하세요. 인스턴스 유형의 기능을 비교하려면 [Amazon EC2 인스턴스 유형](https://aws.amazon.com/ec2/instance-types)을 참조하세요.