

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

# 詳細部署錯誤代碼
<a name="troubleshooting-deployment"></a>

使用這些區段中的錯誤代碼和解決方案，以協助解決使用 Greengrass 核 2.8.0 版或更新版本時元件部署的問題。

Greengrass 核會將部署錯誤報告為從最不特定到最特定可用程式碼的階層。您可以使用此階層來協助找出部署錯誤的原因。例如，下列是可能的錯誤階層：
+ DEPLOYMENT\$1FAILURE
  + ARTIFACT\$1DOWNLOAD\$1ERROR
    + IO\$1ERROR
      + DISK\$1SPACE\$1CRITICAL

錯誤代碼會依類型整理。每種類型都代表可能發生的錯誤類別。 會在主控台、API 和 中 AWS IoT Greengrass 報告這些錯誤類型 AWS CLI。根據錯誤階層中報告的錯誤，可能會有多個錯誤類型。針對上述範例，傳回的錯誤類型為 `DEVICE_ERROR`。

類型為：
+ **PERMISSION\$1ERROR** – 存取需要 許可的操作遭拒。
+ **REQUEST\$1ERROR** – 由於部署文件中的問題而發生錯誤。
+ **COMPONENT\$1RECIPE\$1ERROR** – 由於元件配方中的問題而發生錯誤。
+ **AWS\$1COMPONENT\$1ERROR** – 啟動或移除 AWS 提供的元件時發生錯誤。
+ **USER\$1COMPONENT\$1ERROR** – 啟動或移除使用者元件時發生錯誤。
+ **COMPONENT\$1ERROR** – 啟動或移除元件時發生錯誤，但 Greengrass 核無法判斷元件是 AWS 提供的元件還是使用者元件。
+ **DEVICE\$1ERROR** – 本機 I/O 發生錯誤或發生另一個裝置錯誤。
+ **DEPENDENCY\$1ERROR** – 部署無法從 Amazon S3 下載成品，或無法從 ECR 登錄檔提取映像。
+ **HTTP\$1ERROR** – HTTP 請求發生錯誤。
+ **NETWORK\$1ERROR** – 裝置網路發生錯誤。
+ **NUCLEUS\$1ERROR** – Greengrass 核找不到元件或找不到作用中的核版本。
+ **SERVER\$1ERROR** – 伺服器傳回 500 錯誤以回應請求。
+ **CLOUD\$1SERVICE\$1ERROR** – AWS IoT Greengrass 雲端服務發生錯誤。
+ **UNKNOWN\$1ERROR** – 元件擲回未檢查的例外狀況。

本節中的許多錯誤會報告 AWS IoT Greengrass 核心日誌中的其他資訊。這些日誌存放在核心裝置的本機檔案系統上。 AWS IoT Greengrass 核心軟體和每個個別元件都有日誌。如需存取日誌的資訊，請參閱 [存取檔案系統日誌](monitor-logs.md#access-local-logs)。

## 許可錯誤
<a name="permission-error"></a>

ACCESS\$1DENIED  
當 AWS 服務操作傳回 403 錯誤時，您可能會收到此錯誤，因為未正確設定許可。如需詳細資訊，請檢查更具體的錯誤代碼。

GET\$1DEPLOYMENT\$1CONFIGURATION\$1ACCESS\$1DENIED  
當 AWS IoT 政策不允許呼叫 `GetDeploymentConfiguration`操作的許可時，您可能會收到此錯誤。將 `greengrass::GetDeploymentConfiguration` 許可新增至核心裝置的政策。

GET\$1COMPONENT\$1VERSION\$1ARTIFACT\$1ACCESS\$1DENIED  
當核心裝置 AWS IoT 政策不允許 `greengrass:GetComponentVersionArtifact`許可時，您可能會收到此錯誤。將 許可新增至核心裝置的政策。

RESOLVE\$1COMPONENT\$1CANDIDATES\$1ACCESS\$1DENIED  
當核心裝置 AWS IoT 政策不允許 `greengrass:ResolveComponentCandidates`許可時，您可能會收到此錯誤。將 許可新增至核心裝置的政策。

GET\$1ECR\$1CREDENTIAL\$1ERROR  
當部署無法透過 ECR 中的私有登錄檔進行身分驗證時，您可能會收到此錯誤。檢查日誌是否有特定錯誤，然後再次嘗試部署。

USER\$1NOT\$1AUTHORIZED\$1FOR\$1DOCKER  
當 Greengrass 使用者未獲授權使用 Docker 時，您可能會收到此錯誤。請確定您以根身分執行 Greengrass，或使用者已新增至`docker`群組。然後再次嘗試部署。

S3\$1ACCESS\$1DENIED  
當 Amazon S3 操作傳回 403 錯誤時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

S3\$1HEAD\$1OBJECT\$1ACCESS\$1DENIED  
當裝置的字符交換角色不允許 AWS IoT Greengrass Core 軟體從您在元件配方中指定的 S3 物件 URL 下載元件成品，或元件成品無法使用時，您可能會收到此錯誤。檢查權杖交換角色`s3:GetObject`是否允許使用成品可用的 S3 物件 URL，以及成品是否存在。

S3\$1GET\$1BUCKET\$1LOCATION\$1ACCESS\$1DENIED  
當裝置的字符交換角色不允許提供成品的 Amazon S3 儲存貯體的`s3:GetBucketLocation`許可時，您可能會收到此錯誤。檢查裝置的 是否允許 許可，然後再次嘗試部署。

S3\$1GET\$1OBJECT\$1ACCESS\$1DENIED  
當裝置的字符交換角色不允許 AWS IoT Greengrass Core 軟體從您在元件配方中指定的 S3 物件 URL 下載元件成品，或元件成品無法使用時，您可能會收到此錯誤。檢查權杖交換角色`s3:GetObject`是否允許使用成品可用的 S3 物件 URL，以及成品是否存在。

## 請求錯誤
<a name="request-error"></a>

NUCLEUS\$1MISSING\$1REQUIRED\$1CAPABILITIES  
當部署中的核版本無法執行請求的操作時，您可能會收到此錯誤，例如下載大型組態或設定 Linux 資源限制。使用支援 操作的 nucleus 版本重試部署。

MULTIPLE\$1NUCLEUS\$1RESOLVED\$1ERROR  
部署嘗試部署多個核心元件時，您可能會收到此錯誤。檢查日誌以查看錯誤的原因，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援。

COMPONENT\$1CIRCULAR\$1DEPENDENCY\$1ERROR  
當部署中的兩個元件彼此相依時，您可能會收到此錯誤。修改元件設定，讓部署中的元件不會彼此依賴。

UNAUTHORIZED\$1NUCLEUS\$1MINOR\$1VERSION\$1UPDATE  
當部署中的元件需要更新核心次要版本，但未在部署中指定該版本時，您可能會收到此錯誤。這有助於減少相依於不同版本的元件意外次要版本更新。在部署中包含新的次要核心版本。

MISSING\$1DOCKER\$1APPLICATION\$1MANAGER  
當您在不部署 Docker 應用程式管理員的情況下部署 Docker 元件時，可能會收到此錯誤。請確定您的部署包含 Docker 應用程式管理員。

MISSING\$1TOKEN\$1EXCHANGE\$1SERVICE  
當部署想要從私有 ECR 登錄檔下載 Docker 映像成品而不部署字符交換服務時，您可能會收到此錯誤。請確定您的部署包含權杖交換服務。

COMPONENT\$1VERSION\$1REQUIREMENTS\$1NOT\$1MET  
當版本限制衝突或元件版本不存在時，您可能會收到此錯誤。如需詳細資訊，請參閱[Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component <name> version with cloud and no local applicable version satisfying requirement <requirements>](troubleshooting.md#core-error-no-available-component-version)。

THROTTLING\$1ERROR  
當 AWS 服務操作超過速率配額時，您可能會收到此錯誤。重新嘗試部署。

CONFLICTED\$1REQUEST  
當 AWS 服務操作傳回 409 錯誤時，您可能會收到此錯誤，因為您部署嘗試一次執行多個操作。重新嘗試部署。

RESOURCE\$1NOT\$1FOUND  
當 AWS 服務操作傳回 404 錯誤時，您可能會收到此錯誤，因為找不到資源。檢查日誌是否有遺失的資源。

RUN\$1WITH\$1CONFIG\$1NOT\$1VALID  
當指定執行元件的 `posixUser`、 `posixGroup`或 `windowsUser`資訊無效時，您可能會收到此錯誤。檢查使用者是否有效，然後重試部署。

UNSUPPORTED\$1REGION  
當 不支援為部署指定的區域時，您可能會收到此錯誤 AWS IoT Greengrass。請檢查 區域，然後再試一次部署。

IOT\$1CRED\$1ENDPOINT\$1NOT\$1VALID  
當組態中指定的 AWS IoT 登入資料端點無效時，您可能會收到此錯誤。請檢查端點，然後再試一次您的請求。

IOT\$1DATA\$1ENDPOINT\$1NOT\$1VALID  
當組態中指定的 AWS IoT 資料端點無效時，您可能會收到此錯誤。請檢查端點，然後再試一次您的請求。

S3\$1HEAD\$1OBJECT\$1RESOURCE\$1NOT\$1FOUND  
當您在元件配方中指定的 S3 物件 URL 無法使用元件成品時，您可能會收到此錯誤。確認您已將成品上傳到 S3 儲存貯體，且成品 URI 符合儲存貯體中成品的 S3 物件 URL。

S3\$1GET\$1BUCKET\$1LOCATION\$1RESOURCE\$1NOT\$1FOUND  
找不到 Amazon S3 儲存貯體時，您可能會收到此錯誤。檢查儲存貯體是否存在，然後重試部署。

S3\$1GET\$1OBJECT\$1RESOURCE\$1NOT\$1FOUND  
當您在元件配方中指定的 S3 物件 URL 無法使用元件成品時，您可能會收到此錯誤。確認您已將成品上傳到 S3 儲存貯體，且成品 URI 符合儲存貯體中成品的 S3 物件 URL。

IO\$1MAPPING\$1ERROR  
當剖析部署文件或配方時發生 I/O 錯誤時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

## 元件配方錯誤
<a name="component-recipe-error"></a>

RECIPE\$1PARSE\$1ERROR  
當因為配方的結構發生錯誤而無法剖析部署配方時，您可能會收到此錯誤。檢查配方的格式是否正確，然後重試部署。

RECIPE\$1METADATA\$1PARSE\$1ERROR  
當無法剖析從雲端下載的部署配方中繼資料時，您可能會收到此錯誤。聯絡 支援。

ARTIFACT\$1URI\$1NOT\$1VALID  
當配方中的成品 URI 格式不正確時，您可能會收到此錯誤。檢查日誌中是否有無效 URI、更新配方中的 URI，然後再次嘗試部署。

S3\$1ARTIFACT\$1URI\$1NOT\$1VALID  
當配方中成品的 Amazon S3 URI 無效時，您可能會收到此錯誤。檢查日誌中是否有無效 URI、更新配方中的 URI，然後再次嘗試部署。

DOCKER\$1ARTIFACT\$1URI\$1NOT\$1VALID  
當配方中成品的 Docker URI 無效時，您可能會收到此錯誤。檢查日誌中是否有無效 URI、更新配方中的 URI，然後再次嘗試部署。

EMPTY\$1ARTIFACT\$1URI  
當配方中未指定成品的 URI 時，您可能會收到此錯誤。檢查日誌中是否有缺少 URI 的成品、更新配方中的 URI，然後再次嘗試部署。

EMPTY\$1ARTIFACT\$1SCHEME  
當未為成品定義 URI 結構描述時，您可能會收到此錯誤。檢查日誌中是否有無效 URI、更新配方中的 URI，然後再次嘗試部署。

UNSUPPORTED\$1ARTIFACT\$1SCHEME  
當執行中的 nucleus 版本不支援 URI 結構描述時，您可能會收到此錯誤。URI 無效，或者您需要更新 nucleus 版本。如果 URI 無效，請檢查無效 URI 的日誌、更新配方中的 URI，然後再次嘗試部署。

RECIPE\$1MISSING\$1MANIFEST  
當資訊清單區段未包含在配方中時，您可能會收到此錯誤。將資訊清單新增至配方，然後再次嘗試部署。

RECIPE\$1MISSING\$1ARTIFACT\$1HASH\$1ALGORITHM  
在沒有雜湊演算法的配方中指定非本機成品時，您可能會收到此錯誤。將演算法新增至成品，然後再試一次請求。

ARTIFACT\$1CHECKSUM\$1MISMATCH  
當下載的成品與配方中指定的摘要不同時，您可能會收到此錯誤。請確定配方包含正確的摘要，然後再次嘗試部署。如需更多資訊，請參閱[Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption.](troubleshooting.md#core-error-failed-to-download-artifact-checksum-mismatch-exception)。

COMPONENT\$1DEPENDENCY\$1NOT\$1VALID  
當部署配方中指定的相依性類型無效時，您可能會收到此錯誤。請檢查配方，然後再試一次您的請求。

CONFIG\$1INTERPOLATE\$1ERROR  
插入配方變數時，您可能會收到此錯誤。如需詳細資訊，請檢查日誌。

IO\$1MAPPING\$1ERROR  
當剖析部署文件或配方時發生 I/O 錯誤時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

## AWS 元件錯誤、使用者元件錯誤、元件錯誤
<a name="component-error"></a>

當元件發生問題時，會傳回下列錯誤代碼。報告的實際錯誤類型取決於引發錯誤的特定元件。如果 Greengrass 核將元件識別為 提供的元件 AWS IoT Greengrass，則會傳回 `AWS_COMPONENT_ERROR`。如果將元件識別為使用者元件，Greengrass 核會傳回 `USER_COMPONENT_ERROR`。如果 Greengrass 核無法告知，則會傳回 `COMPONENT_ERROR`。

COMPONENT\$1UPDATE\$1ERROR  
當元件在部署期間未更新時，您可能會收到此錯誤。檢查任何其他錯誤代碼或檢查日誌，以查看造成錯誤的原因。

COMPONENT\$1BROKEN  
當元件在部署期間損壞時，您可能會收到此錯誤。檢查元件日誌以取得錯誤詳細資訊，然後再次嘗試部署。

REMOVE\$1COMPONENT\$1ERROR  
當核心無法在部署期間移除元件時，您可能會收到此錯誤。請檢查日誌以取得錯誤詳細資訊，然後再次嘗試部署。

COMPONENT\$1BOOTSTRAP\$1TIMEOUT  
當元件的引導任務花費超過設定的逾時時間時，您可能會收到此錯誤。增加逾時或縮短引導任務的執行時間，然後再次嘗試部署。

COMPONENT\$1BOOTSTRAP\$1ERROR  
當元件的引導任務發生錯誤時，您可能會收到此錯誤。請檢查日誌以取得錯誤詳細資訊，然後再次嘗試部署。

COMPONENT\$1CONFIGURATION\$1NOT\$1VALID  
當核心無法驗證元件的部署組態時，您可能會收到此錯誤。請檢查日誌以取得錯誤詳細資訊，然後再次嘗試部署。

## 裝置錯誤
<a name="device-error"></a>

IO\$1WRITE\$1ERROR  
寫入檔案時，您可能會收到此錯誤。如需詳細資訊，請檢查日誌。

IO\$1READ\$1ERROR  
從檔案讀取時，您可能會收到此錯誤。如需詳細資訊，請檢查日誌。

DISK\$1SPACE\$1CRITICAL  
當磁碟空間不足而無法完成部署請求時，您可能會收到此錯誤。您必須擁有至少 20 Mb 的可用空間，或足以容納較大的成品。釋放一些磁碟空間，然後重試部署。

IO\$1FILE\$1ATTRIBUTE\$1ERROR  
當無法從檔案系統擷取現有檔案大小時，您可能會收到此錯誤。如需詳細資訊，請檢查日誌。

SET\$1PERMISSION\$1ERROR  
當無法在下載的成品或成品目錄上設定許可時，您可能會收到此錯誤。如需詳細資訊，請檢查日誌。

IO\$1UNZIP\$1ERROR  
當成品無法解壓縮時，您可能會收到此錯誤。如需詳細資訊，請檢查日誌。

LOCAL\$1RECIPE\$1NOT\$1FOUND  
找不到配方檔案的本機副本時，您可能會收到此錯誤。再次嘗試部署。

LOCAL\$1RECIPE\$1CORRUPTED  
當配方的本機複本自下載以來已變更時，您可能會收到此錯誤。刪除配方的現有副本，然後重試部署。

LOCAL\$1RECIPE\$1METADATA\$1NOT\$1FOUND  
找不到配方中繼資料檔案的本機副本時，您可能會收到此錯誤。再次嘗試部署。

LAUNCH\$1DIRECTORY\$1CORRUPTED  
當用於啟動 Greengrass 核的目錄 (`/greengrass/v2/alts/current`) 自上次啟動核之後已經過修改時，您可能會收到此錯誤。重新啟動核心，然後重試部署。

HASHING\$1ALGORITHM\$1UNAVAILABLE  
當裝置的 Java 分佈不支援所需的雜湊演算法，或元件配方中指定的雜湊演算法無效時，您可能會收到此錯誤。

DEVICE\$1CONFIG\$1NOT\$1VALID\$1FOR\$1ARTIFACT\$1DOWNLOAD  
當裝置組態發生錯誤，導致部署無法從 Amazon S3 或 Greengrass 雲端下載成品時，您可能會收到此錯誤。檢查日誌是否有特定的組態錯誤，然後重試部署。

## 相依性錯誤
<a name="dependency-error"></a>

DOCKER\$1ERROR  
您可能會在提取 Docker 映像時收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

DOCKER\$1SERVICE\$1UNAVAILABLE  
當 Greengrass 無法登入 Docker 登錄檔時，您可能會收到此錯誤。檢查日誌是否有特定錯誤，然後再次嘗試部署。

DOCKER\$1LOGIN\$1ERROR  
當登入 Docker 時發生意外錯誤時，您可能會收到此錯誤。檢查日誌是否有特定錯誤，然後再次嘗試部署。

DOCKER\$1PULL\$1ERROR  
當從登錄檔提取 Docker 映像時發生意外錯誤時，您可能會收到此錯誤。檢查日誌是否有特定錯誤，然後再次嘗試部署。

DOCKER\$1IMAGE\$1NOT\$1VALID  
當請求的 Docker 映像不存在時，您可能會收到此錯誤。檢查日誌是否有特定錯誤，然後重試部署。

DOCKER\$1IMAGE\$1QUERY\$1ERROR  
查詢 Docker 是否有可用的映像時發生非預期的失敗時，您可能會收到此錯誤。檢查日誌是否有特定錯誤，然後重試部署。

S3\$1ERROR  
下載 Amazon S3 成品時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

S3\$1RESOURCE\$1NOT\$1FOUND  
當 Amazon S3 操作傳回 404 錯誤時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

S3\$1BAD\$1REQUEST  
當 Amazon S3 操作傳回 400 錯誤時，您可能會收到此錯誤。檢查日誌是否有特定錯誤，然後再試一次請求。

## HTTP 錯誤
<a name="http-error"></a>

HTTP\$1REQUEST\$1ERROR  
當提出 HTTP 請求時發生錯誤時，您可能會收到此錯誤。檢查日誌是否有特定錯誤。

DOWNLOAD\$1DEPLOYMENT\$1DOCUMENT\$1ERROR  
當下載部署文件時發生 HTTP 錯誤時，您可能會收到此錯誤。檢查日誌是否有特定的 HTTP 錯誤。

GET\$1GREENGRASS\$1ARTIFACT\$1SIZE\$1ERROR  
當取得公有元件成品的大小時發生 HTTP 錯誤時，您可能會收到此錯誤。檢查日誌是否有特定的 HTTP 錯誤。

DOWNLOAD\$1GREENGRASS\$1ARTIFACT\$1ERROR  
當下載公有元件成品時發生 HTTP 錯誤時，您可能會收到此錯誤。檢查日誌是否有特定的 HTTP 錯誤。

## 網路錯誤
<a name="network-error"></a>

NETWORK\$1ERROR  
在部署期間發生連線問題時，您可能會收到此錯誤。檢查裝置與網際網路的連線，然後重試部署。

## Nucleus 錯誤
<a name="nucleus-error"></a>

BAD\$1REQUEST  
當 AWS 雲端操作傳回 400 錯誤時，您可能會收到此錯誤。檢查日誌以查看導致錯誤的 API，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡案例 支援。

NUCLEUS\$1VERSION\$1NOT\$1FOUND  
當核心裝置找不到作用中核心的版本時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援案例。

NUCLEUS\$1RESTART\$1FAILURE  
當核心在需要重新啟動的部署期間未重新啟動時，您可能會收到此錯誤。檢查載入器日誌以查看錯誤的原因，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡案例 支援。

INSTALLED\$1COMPONENT\$1NOT\$1FOUND  
當核心找不到已安裝的元件時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援案例。

DEPLOYMENT\$1DOCUMENT\$1NOT\$1VALID  
當裝置收到無效的部署文件時，您可能會收到此錯誤。檢查任何其他錯誤代碼或檢查日誌，以查看造成錯誤的原因。

EMPTY\$1DEPLOYMENT\$1REQUEST  
當裝置收到空的部署請求時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援案例。

DEPLOYMENT\$1DOCUMENT\$1PARSE\$1ERROR  
當部署請求格式不符合預期的格式時，您可能會收到此錯誤。檢查日誌以查看錯誤的原因，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援。

COMPONENT\$1METADATA\$1NOT\$1VALID\$1IN\$1DEPLOYMENT  
當部署請求包含無效的元件中繼資料時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援案例。

LAUNCH\$1DIRECTORY\$1CORRUPTED  
當您將 Greengrass 裝置從一個物件群組移至另一個物件群組，然後使用需要 Greengrass 重新啟動的部署返回原始群組時，您可能會收到此錯誤。若要解決錯誤，請在裝置上重新建立 Greengrass 的啟動目錄。  
如需詳細資訊，請參閱[Error: com.aws.greengrass.deployment.exceptions.DeploymentException: Unable to process deployment. Greengrass launch directory is not set up or Greengrass is not set up as a system service](troubleshooting.md#deployment-error-unable-to-process-deployment)。

## 伺服器錯誤
<a name="server-error"></a>

SERVER\$1ERROR  
當 AWS 服務操作傳回 500 錯誤時，您可能會收到此錯誤，因為服務目前無法處理請求。稍後重試部署。

S3\$1SERVER\$1ERROR  
當 Amazon S3 操作傳回 500 錯誤時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

## 雲端服務錯誤
<a name="cloud-service-error"></a>

RESOLVE\$1COMPONENT\$1CANDIDATES\$1BAD\$1RESPONSE  
當 Greengrass 雲端服務傳送不相容的回應給 `ResolveComponentCandidates`操作時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡案例 支援。

DEPLOYMENT\$1DOCUMENT\$1SIZE\$1EXCEEDED  
當請求的部署文件超過大小配額上限時，您可能會收到此錯誤。減少部署文件的大小，然後再試一次部署。

GREENGRASS\$1ARTIFACT\$1SIZE\$1NOT\$1FOUND  
當 Greengrass 無法取得公有元件成品的大小時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡案例 支援。

DEPLOYMENT\$1DOCUMENT\$1NOT\$1VALID  
當裝置收到無效的部署文件時，您可能會收到此錯誤。檢查任何其他錯誤代碼或檢查日誌，以查看造成錯誤的原因。

EMPTY\$1DEPLOYMENT\$1REQUEST  
當裝置收到空的部署請求時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡案例 支援。

DEPLOYMENT\$1DOCUMENT\$1PARSE\$1ERROR  
當部署請求格式不符合預期的格式時，您可能會收到此錯誤。檢查日誌以查看錯誤的原因，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援。

COMPONENT\$1METADATA\$1NOT\$1VALID\$1IN\$1DEPLOYMENT  
當部署請求包含無效的元件中繼資料時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡案例 支援。

## 一般錯誤
<a name="generic-error"></a>

這些一般錯誤沒有相關聯的錯誤類型。

DEPLOYMENT\$1INTERRUPTED  
當部署因為核心關閉或其他外部事件而無法完成時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

ARTIFACT\$1DOWNLOAD\$1ERROR  
當下載成品發生問題時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

NO\$1AVAILABLE\$1COMPONENT\$1VERSION  
當元件版本不存在於雲端或本機，或存在相依性解析衝突時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

COMPONENT\$1PACKAGE\$1LOADING\$1ERROR  
當錯誤處理下載的成品時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

CLOUD\$1API\$1ERROR  
當呼叫 AWS 服務 API 時發生錯誤時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

IO\$1ERROR  
當部署期間發生 I/O 錯誤時，您可能會收到此錯誤。如需詳細資訊，請檢查任何其他錯誤代碼或日誌。

COMPONENT\$1UPDATE\$1ERROR  
當元件在部署期間未更新時，您可能會收到此錯誤。檢查任何其他錯誤代碼或檢查日誌，以查看造成錯誤的原因。

## 未知錯誤
<a name="unknown-error"></a>

DEPLOYMENT\$1FAILURE  
當部署因為擲出未檢查的例外狀況而失敗時，您可能會收到此錯誤。檢查日誌以查看錯誤的原因，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡 支援。

DEPLOYMENT\$1TYPE\$1NOT\$1VALID  
當部署類型無效時，您可能會收到此錯誤。檢查日誌以查看造成錯誤的因素，然後檢查 nucleus 軟體更新頁面，查看此問題是否已在更新版本的 nucleus 中修正，或聯絡案例 支援。