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

# 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)。

## Resolution
<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` 日誌以取得詳細資訊。您可以在此 Amazon S3 位置尋找引導操作的 `stdout` 日誌：

   ```
   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)。

## Resolution
<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` 日誌以取得詳細資訊。您可以在此 Amazon S3 位置尋找引導操作的 `stdout` 日誌：

   ```
   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 儲存貯體下載的引導操作指令碼。

## Resolution
<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` 資料夾中檔案的自訂程序。您可以在此 Amazon S3 位置尋找引導操作的 `stdout` 日誌：

   ```
   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` 錯誤表示主要執行個體在安裝必要的軟體時沒有足夠的磁碟空間。

## Resolution
<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` 錯誤表示一或多個工作者執行個體在安裝必要的軟體時沒有足夠的磁碟空間。

## Resolution
<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`**  
磁碟空間不足的工作者執行個體 IDs。

**`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 中繼存放區建立連線。

## Resolution
<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`**  
主要執行個體的 ID 無法與設定的外部 Hive 中繼存放區建立連線。

**`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 中繼存放區建立連線。

## Resolution
<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`**  
工作者執行個體IDs 無法與設定的外部 Hive 中繼存放區建立連線。

**`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)。

## Resolution
<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 管理指南》**中的 [設定 Spot 執行個體的 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 無法滿足您對主節點的 Spot 執行個體請求時，叢集會終止並顯示 `INTERNAL_ERROR_SPOT_PRICE_INCREASE_PRIMARY` 錯誤，因為執行個體無法以等於或低於您的最高 Spot 價格提供。如需詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的[Spot 執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html)。

## Resolution
<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 Spot 執行個體的最佳實務，並檢閱您的叢集組態策略。如需詳細資訊，請參閱《Amazon [ EC2 使用者指南》中的 EC2 Spot 最佳實務](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-best-practices.html)和 [設定 Spot 執行個體的 Amazon EMR 叢集執行個體類型和最佳實務](emr-plan-instances-guidelines.md)。 *Amazon EC2 * 

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>

在沒有足夠容量來滿足主節點的 Spot 執行個體請求時，叢集會終止並顯示 `INTERNAL_ERROR_SPOT_NO_CAPACITY_PRIMARY` 錯誤。如需詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的[Spot 執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html)。

## Resolution
<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 Spot 執行個體的最佳實務，並檢閱您的叢集組態策略。如需詳細資訊，請參閱《Amazon [ EC2 使用者指南》中的 EC2 Spot 最佳實務](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-best-practices.html)和 [設定 Spot 執行個體的 Amazon EMR 叢集執行個體類型和最佳實務](emr-plan-instances-guidelines.md)。 *Amazon EC2 * 

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>

當您的叢集和您為叢集參考的子網路屬於不同的虛擬私有雲端 (VPC) 時，叢集將終止並顯示 `VALIDATION_ERROR_SUBNET_NOT_FROM_ONE_VPC` 錯誤。您可以使用 Amazon EMR 啟動叢集，並在 VPC 中跨子網路設定執行個體機群。如需有關執行個體機群的詳細資訊，請參閱《Amazon EMR 管理指南》**中 [為您的 Amazon EMR 叢集規劃和設定執行個體機群](emr-instance-fleet.md)。

## Resolution
<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 虛擬私有雲端使用者指南》**中的[建立子網路](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>

當您的叢集和指派給叢集的安全群組屬於不同的虛擬私有雲端 (VPC) 時，叢集將終止並顯示 `VALIDATION_ERROR_SECURITY_GROUP_NOT_FROM_ONE_VPC` 錯誤。如需有關安全群組的詳細資訊，請參閱 [指定 Amazon EMR 受管安全群組和額外的安全群組](emr-sg-specify.md) 和 [使用 Amazon EMR 叢集的安全群組控制網路流量](emr-security-groups.md)。

## Resolution
<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)。 *Amazon EC2 *

## Resolution
<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 管理主控台。

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)。

## Resolution
<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)。