

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 詳細なデプロイエラーコード
<a name="troubleshooting-deployment"></a>

これらのセクションのエラーコードと解決方法を参考にして、Greengrass nucleus バージョン 2.8.0 以降を使用する際のコンポーネントのデプロイの問題の解決に役立ててください。

Greengrass nucleus は、入手可能な最も具体的でないコードから最も具体的なコードまでの階層として、デプロイエラーを報告します。この階層を使用すると、デプロイエラーの原因を特定するのに役立ちます。例えば、エラー階層としては、次のようなものが考えられます。
+ DEPLOYMENT\_FAILURE
  + ARTIFACT\_DOWNLOAD\_ERROR
    + IO\_ERROR
      + DISK\_SPACE\_CRITICAL

エラーコードは、複数のタイプに整理されています。各タイプは、発生する可能性のあるエラーのクラスを表します。 AWS IoT Greengrass は、コンソール、API、および でこれらのエラータイプを報告します AWS CLI。エラー階層で報告されるエラーによっては、複数のエラータイプが存在する可能性があります。前述の例では、返されるエラータイプは `DEVICE_ERROR` です。

タイプは次のとおりです。
+ **PERMISSION\_ERROR** — 許可を必要とするオペレーションへのアクセスが拒否されました。
+ **REQUEST\_ERROR** — デプロイドキュメント内の問題が原因でエラーが発生しました。
+ **COMPONENT\_RECIPE\_ERROR** — コンポーネント recipe の問題が原因でエラーが発生しました。
+ **AWS\_COMPONENT\_ERROR** – AWS 指定されたコンポーネントを起動または削除するときにエラーが発生しました。
+ **USER\_COMPONENT\_ERROR** — ユーザーコンポーネントの起動時または削除時にエラーが発生しました。
+ **COMPONENT\_ERROR** – コンポーネントの開始時または削除時にエラーが発生しましたが、Greengrass nucleus は、そのコンポーネントが、 AWS が提供するコンポーネントであるか、またはユーザーコンポーネントであるかを判断できませんでした。
+ **DEVICE\_ERROR** — ローカル I/O でエラーが発生したか、別のデバイスエラーが発生しました。
+ **DEPENDENCY\_ERROR** — デプロイが Amazon S3 からアーティファクトをダウンロードしたり、ECR レジストリからイメージをプルしたりできませんでした。
+ **HTTP\_ERROR** — HTTP リクエストでエラーが発生しました。
+ **NETWORK\_ERROR** — デバイスネットワークでエラーが発生しました。
+ **NUCLEUS\_ERROR** — Greengrass nucleus がコンポーネントまたはアクティブな nucleus バージョンを見つけることができませんでした。
+ **SERVER\_ERROR** — リクエストに対するレスポンスとして、サーバーが 500 エラーを返しました。
+ **CLOUD\_SERVICE\_ERROR** – AWS IoT Greengrass クラウドサービスでエラーが発生しました。
+ **UNKNOWN\_ERROR** — コンポーネントによって未チェックの例外がスローされました。

このセクションのエラーの多くは、 AWS IoT Greengrass Core ログの追加情報を報告します。これらのログは、コアデバイスのローカルファイルシステムに保存されます。 AWS IoT Greengrass Core コアソフトウェアと個々のコンポーネントのログがあります。ログへのアクセスに関する詳細については、「[ファイル システム ログをアクセス](monitor-logs.md#access-local-logs)」を参照してください。

## アクセス許可エラー
<a name="permission-error"></a>

ACCESS\_DENIED  
アクセス許可が正しく設定されていないため、 AWS サービスオペレーションが 403 エラーを返すと、このエラーが発生することがあります。詳細については、より具体的なエラーコードを確認してください。

GET\_DEPLOYMENT\_CONFIGURATION\_ACCESS\_DENIED  
このエラーは、 AWS IoT ポリシーが `GetDeploymentConfiguration`オペレーションを呼び出すアクセス許可を許可していない場合に表示されることがあります。`greengrass::GetDeploymentConfiguration` 許可をコアデバイスのポリシーに追加します。

GET\_COMPONENT\_VERSION\_ARTIFACT\_ACCESS\_DENIED  
このエラーは、コアデバイス AWS IoT ポリシーで アクセス`greengrass:GetComponentVersionArtifact`許可が許可されていない場合に表示されることがあります。許可をコアデバイスのポリシーに追加します。

RESOLVE\_COMPONENT\_CANDIDATES\_ACCESS\_DENIED  
このエラーは、コアデバイス AWS IoT ポリシーで アクセス`greengrass:ResolveComponentCandidates`許可が許可されていない場合に表示されることがあります。許可をコアデバイスのポリシーに追加します。

GET\_ECR\_CREDENTIAL\_ERROR  
このエラーは、デプロイが ECR のプライベートレジストリで認証できなかった場合に表示されることがあります。特定のエラーがないかをログで確認してから、デプロイを再試行してください。

USER\_NOT\_AUTHORIZED\_FOR\_DOCKER  
このエラーは、Greengrass ユーザーに Docker を使用する権限がない場合に表示されることがあります。Greengrass をルートとして実行していること、またはユーザーが `docker` グループに追加されていることを確認してください。その後、デプロイを再試行してください。

S3\_ACCESS\_DENIED  
このエラーは、Amazon S3 オペレーションが 403 エラーを返した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

S3\_HEAD\_OBJECT\_ACCESS\_DENIED  
このエラーは、 AWS IoT Greengrass Core ソフトウェアがコンポーネントの recipe で指定した S3 オブジェクト URL からコンポーネントアーティファクトをダウンロードすることをデバイスのトークン交換ロールが許可しない場合、またはコンポーネントアーティファクトが利用できない場合に表示されることがあります。トークン交換ロールで、アーティファクトが利用可能で、かつ、アーティファクトが存在している S3 オブジェクト URL の `s3:GetObject` が許可されていることを確認してください。

S3\_GET\_BUCKET\_LOCATION\_ACCESS\_DENIED  
このエラーは、アーティファクトが利用可能な Amazon S3 バケットに対して、デバイスのトークン交換ロールが `s3:GetBucketLocation` 許可を付与していない場合に表示されることがあります。デバイスが許可を付与していることを確認してから、デプロイを再試行してください。

S3\_GET\_OBJECT\_ACCESS\_DENIED  
このエラーは、 AWS IoT Greengrass Core ソフトウェアがコンポーネントの recipe で指定した S3 オブジェクト URL からコンポーネントアーティファクトをダウンロードすることをデバイスのトークン交換ロールが許可しない場合、またはコンポーネントアーティファクトが利用できない場合に表示されることがあります。トークン交換ロールで、アーティファクトが利用可能で、かつ、アーティファクトが存在している S3 オブジェクト URL の `s3:GetObject` が許可されていることを確認してください。

## リクエストエラー
<a name="request-error"></a>

NUCLEUS\_MISSING\_REQUIRED\_CAPABILITIES  
このエラーは、デプロイの nucleus バージョンが、リクエストされたオペレーション (大規模な設定のダウンロードや Linux リソース制限の設定など) に対応していない場合に表示されることがあります。オペレーションをサポートする nucleus バージョンでデプロイを再試行してください。

MULTIPLE\_NUCLEUS\_RESOLVED\_ERROR  
このエラーは、デプロイが複数の nucleus コンポーネントをデプロイしようとした場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

COMPONENT\_CIRCULAR\_DEPENDENCY\_ERROR  
このエラーは、デプロイ内の 2 つのコンポーネントが相互に依拠している場合に表示されることがあります。デプロイ内のコンポーネントが相互に依拠しないように、コンポーネントの設定を見直します。

UNAUTHORIZED\_NUCLEUS\_MINOR\_VERSION\_UPDATE  
このエラーは、デプロイ内のコンポーネントが nucleus のマイナーバージョン更新を必要とするものの、そのバージョンがデプロイで指定されていない場合に表示されることがあります。これは、別のバージョンに依拠するコンポーネントが、意図せずにマイナーバージョン更新されるのを防ぐのに役立ちます。デプロイに新しいマイナー nucleus バージョンを含めてください。

MISSING\_DOCKER\_APPLICATION\_MANAGER  
このエラーは、Docker アプリケーションマネージャーをデプロイせずに Docker コンポーネントをデプロイする場合に表示されることがあります。デプロイに Docker アプリケーションマネージャーが含まれていることを確認してください。

MISSING\_TOKEN\_EXCHANGE\_SERVICE  
このエラーは、デプロイがトークン交換サービスをデプロイせずに、プライベート ECR レジストリから Docker イメージアーティファクトをダウンロードする場合に表示されることがあります。デプロイにトークン交換サービスが含まれていることを確認してください。

COMPONENT\_VERSION\_REQUIREMENTS\_NOT\_MET  
このエラーは、バージョン制約が競合しているか、コンポーネントバージョンが存在しない場合に表示されることがあります。詳細については、「[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\_ERROR  
このエラーは、 AWS サービスオペレーションがレートクォータを超えたときに発生することがあります。デプロイを再試行します。

CONFLICTED\_REQUEST  
デプロイが一度に複数のオペレーションを実行しようとしているため、 AWS サービスオペレーションが 409 エラーを返すと、このエラーが発生することがあります。デプロイを再試行します。

RESOURCE\_NOT\_FOUND  
リソースが見つからなかったため、 AWS サービスオペレーションが 404 エラーを返すと、このエラーが発生することがあります。見つからないリソースについては、ログを確認してください。

RUN\_WITH\_CONFIG\_NOT\_VALID  
このエラーは、コンポーネントを実行するために指定された `posixUser`、`posixGroup`、または `windowsUser` 情報が有効でない場合に表示されることがあります。ユーザーが有効であることを確認してから、デプロイを再試行してください。

UNSUPPORTED\_REGION  
このエラーは、デプロイに指定されたリージョンが AWS IoT Greengrassによってサポートされていない場合に表示されることがあります。リージョンを確認して、デプロイを再試行してください。

IOT\_CRED\_ENDPOINT\_NOT\_VALID  
このエラーは、設定で指定された AWS IoT 認証情報エンドポイントが有効でない場合に表示されることがあります。エンドポイントを確認して、リクエストを再試行してください。

IOT\_DATA\_ENDPOINT\_NOT\_VALID  
このエラーは、設定で指定された AWS IoT データエンドポイントが有効でない場合に表示されることがあります。エンドポイントを確認して、リクエストを再試行してください。

S3\_HEAD\_OBJECT\_RESOURCE\_NOT\_FOUND  
このエラーは、コンポーネントのアーティファクトが、コンポーネントの recipe で指定した S3 オブジェクト URL では利用できない場合に表示されることがあります。アーティファクトを S3 バケットにアップロードしたこと、アーティファクトの URI がバケット内のアーティファクトの S3 オブジェクト URL と一致していることを確認します。

S3\_GET\_BUCKET\_LOCATION\_RESOURCE\_NOT\_FOUND  
このエラーは、Amazon S3 バケットが見つからない場合に表示されることがあります。バケットが存在することを確認して、デプロイを再試行してください。

S3\_GET\_OBJECT\_RESOURCE\_NOT\_FOUND  
このエラーは、コンポーネントのアーティファクトが、コンポーネントの recipe で指定した S3 オブジェクト URL では利用できない場合に表示されることがあります。アーティファクトを S3 バケットにアップロードしたこと、アーティファクトの URI がバケット内のアーティファクトの S3 オブジェクト URL と一致していることを確認します。

IO\_MAPPING\_ERROR  
このエラーは、デプロイドキュメントまたは recipe を解析しているときに I/O エラーが発生した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

## コンポーネント recipe エラー
<a name="component-recipe-error"></a>

RECIPE\_PARSE\_ERROR  
このエラーは、recipe の構造にエラーがあるためにデプロイ recipe を解析できなかった場合に表示されることがあります。recipe が正しくフォーマットされていることを確認して、デプロイを再試行してください。

RECIPE\_METADATA\_PARSE\_ERROR  
このエラーは、クラウドからダウンロードしたデプロイ recipe のメタデータを解析できなかった場合に表示されることがあります。連絡先 サポート。

ARTIFACT\_URI\_NOT\_VALID  
このエラーは、recipe 内のアーティファクト URI が正しくフォーマットされていない場合に表示されることがあります。ログで有効でない URI を確認し、recipe 内の URI を更新してから、デプロイを再試行してください。

S3\_ARTIFACT\_URI\_NOT\_VALID  
このエラーは、recipe 内のアーティファクトの Amazon S3 URI が有効でない場合に表示されることがあります。ログで有効でない URI を確認し、recipe 内の URI を更新してから、デプロイを再試行してください。

DOCKER\_ARTIFACT\_URI\_NOT\_VALID  
このエラーは、recipe 内のアーティファクトの Docker URI が有効でない場合に表示されることがあります。ログで有効でない URI を確認し、recipe 内の URI を更新してから、デプロイを再試行してください。

EMPTY\_ARTIFACT\_URI  
このエラーは、アーティファクトの URI が recipe で指定されていない場合に表示されることがあります。URI が欠落しているアーティファクトをログで確認し、recipe 内の URI を更新してから、デプロイを再試行してください。

EMPTY\_ARTIFACT\_SCHEME  
このエラーは、アーティファクトの URI スキームが定義されていない場合に表示されることがあります。ログで有効でない URI を確認し、recipe 内の URI を更新してから、デプロイを再試行してください。

UNSUPPORTED\_ARTIFACT\_SCHEME  
このエラーは、実行中の nucleus バージョンによって URI スキームがサポートされていない場合に表示されることがあります。URI が有効でないか、nucleus のバージョンを更新する必要があります。URI が有効でない場合は、ログで有効でない URI を確認し、recipe 内の URI を更新してから、デプロイを再試行してください。

RECIPE\_MISSING\_MANIFEST  
このエラーは、マニフェストセクションが recipe に含まれていない場合に表示されることがあります。マニフェストを recipe に追加して、デプロイを再試行してください。

RECIPE\_MISSING\_ARTIFACT\_HASH\_ALGORITHM  
このエラーは、ローカルではないアーティファクトがハッシュアルゴリズムのない recipe 内で指定された場合に表示されることがあります。アーティファクトにアルゴリズムを追加してから、リクエストを再試行してください。

ARTIFACT\_CHECKSUM\_MISMATCH  
このエラーは、ダウンロードしたアーティファクトのダイジェストが recipe で指定されたものと異なる場合に表示されることがあります。recipe に正しいダイジェストが含まれていることを確認してから、デプロイを再試行してください。詳細については、「[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\_DEPENDENCY\_NOT\_VALID  
このエラーは、デプロイ recipe で指定された依存関係タイプが有効でない場合に表示されることがあります。recipe を確認してから、リクエストを再試行してください。

CONFIG\_INTERPOLATE\_ERROR  
このエラーは、recipe 変数を補間する場合に表示されることがあります。詳細については、ログを確認してください。

IO\_MAPPING\_ERROR  
このエラーは、デプロイドキュメントまたは recipe を解析しているときに I/O エラーが発生した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

## AWS コンポーネントエラー、ユーザーコンポーネントエラー、コンポーネントエラー
<a name="component-error"></a>

コンポーネントに問題があると、次のエラーコードが返されます。実際に報告されるエラータイプは、エラーを発生させた特定のコンポーネントによって異なります。Greengrass nucleus がコンポーネントを が提供するコンポーネントとして識別した場合 AWS IoT Greengrass、 を返します`AWS_COMPONENT_ERROR`。コンポーネントがユーザーコンポーネントとして識別された場合、Greengrass nucleus は `USER_COMPONENT_ERROR` を返します。Greengrass nucleus が判別できない場合は、`COMPONENT_ERROR` を返します。

COMPONENT\_UPDATE\_ERROR  
このエラーは、デプロイ中にコンポーネントが更新されない場合に表示されることがあります。その他のエラーコードを確認するか、ログでエラーの原因を確認してください。

COMPONENT\_BROKEN  
このエラーは、デプロイ中にコンポーネントが壊れた場合に表示されることがあります。コンポーネントログでエラーの詳細を確認してから、デプロイを再試行してください。

REMOVE\_COMPONENT\_ERROR  
このエラーは、デプロイ中に nucleus がコンポーネントを削除できない場合に表示されることがあります。ログでエラーの詳細を確認してから、デプロイを再試行してください。

COMPONENT\_BOOTSTRAP\_TIMEOUT  
このエラーは、設定されたタイムアウトよりもコンポーネントのブートストラップタスクが長い時間を要した場合に表示されることがあります。タイムアウトの値を引き上げるか、ブートストラップタスクの実行時間を短くしてから、デプロイを再試行してください。

COMPONENT\_BOOTSTRAP\_ERROR  
このエラーは、コンポーネントのブートストラップタスクにエラーがある場合に表示されることがあります。ログでエラーの詳細を確認してから、デプロイを再試行してください。

COMPONENT\_CONFIGURATION\_NOT\_VALID  
このエラーは、nucleus がコンポーネントのデプロイされた設定を検証できない場合に表示されることがあります。ログでエラーの詳細を確認してから、デプロイを再試行してください。

## デバイスエラー
<a name="device-error"></a>

IO\_WRITE\_ERROR  
このエラーは、ファイルへの書き込み時に表示されることがあります。詳細については、ログを確認してください。

IO\_READ\_ERROR  
このエラーは、ファイルからの読み取り時に表示されることがあります。詳細については、ログを確認してください。

DISK\_SPACE\_CRITICAL  
このエラーは、デプロイリクエストを完了するのに十分なディスク容量がない場合に表示されることがあります。少なくとも 20 MB の空き容量、またはより大きなアーティファクトを保持するのに十分な容量が必要です。ディスク容量をある程度解放してから、デプロイを再試行してください。

IO\_FILE\_ATTRIBUTE\_ERROR  
このエラーは、既存のファイルサイズをファイルシステムから取得できない場合に表示されることがあります。詳細については、ログを確認してください。

SET\_PERMISSION\_ERROR  
このエラーは、ダウンロードしたアーティファクトまたはアーティファクトディレクトリに許可を設定できない場合に表示されることがあります。詳細については、ログを確認してください。

IO\_UNZIP\_ERROR  
このエラーは、アーティファクトを解凍できない場合に表示されることがあります。詳細については、ログを確認してください。

LOCAL\_RECIPE\_NOT\_FOUND  
このエラーは、recipe ファイルのローカルコピーが見つからなかった場合に表示されることがあります。デプロイを再試行してください。

LOCAL\_RECIPE\_CORRUPTED  
このエラーは、ダウンロード後に recipe のローカルコピーが変更された場合に表示されることがあります。recipe の既存のコピーを削除して、デプロイを再試行してください。

LOCAL\_RECIPE\_METADATA\_NOT\_FOUND  
このエラーは、recipe メタデータファイルのローカルコピーが見つからなかった場合に表示されることがあります。デプロイを再試行してください。

LAUNCH\_DIRECTORY\_CORRUPTED  
このエラーは、Greengrass nucleus (`/greengrass/v2/alts/current`) の起動に使用されたディレクトリが、最後に nucleus が起動された後に変更されている場合に表示されることがあります。nucleus を再起動してから、デプロイを再試行してください。

HASHING\_ALGORITHM\_UNAVAILABLE  
このエラーは、デバイスの Java ディストリビューションが必要なハッシュアルゴリズムをサポートしていない場合や、コンポーネント recipe で指定されたハッシュアルゴリズムが有効でない場合に表示されることがあります。

DEVICE\_CONFIG\_NOT\_VALID\_FOR\_ARTIFACT\_DOWNLOAD  
このエラーは、デバイス設定にエラーがあり、デプロイが Amazon S3 または Greengrass クラウドからアーティファクトをダウンロードできなかった場合に表示されることがあります。ログに特定の設定エラーがないか確認してから、デプロイを再試行してください。

## 依存関係のエラー
<a name="dependency-error"></a>

DOCKER\_ERROR  
このエラーは、Docker イメージをプルする場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

DOCKER\_SERVICE\_UNAVAILABLE  
このエラーは、Greengrass が Docker レジストリにログインできなかった場合に表示されることがあります。特定のエラーがないかをログで確認してから、デプロイを再試行してください。

DOCKER\_LOGIN\_ERROR  
このエラーは、Docker へのログイン時に予期しないエラーが発生した場合に表示されることがあります。特定のエラーがないかをログで確認してから、デプロイを再試行してください。

DOCKER\_PULL\_ERROR  
このエラーは、レジストリから Docker イメージをプルする際に予期しないエラーが発生した場合に表示されることがあります。特定のエラーがないかをログで確認してから、デプロイを再試行してください。

DOCKER\_IMAGE\_NOT\_VALID  
このエラーは、リクエストされた Docker イメージが存在しない場合に表示されることがあります。特定のエラーがないかをログで確認し、デプロイを再試行してください。

DOCKER\_IMAGE\_QUERY\_ERROR  
使用可能なイメージについて Docker をクエリする際に予期しない障害が発生すると、このエラーが発生する可能性があります。特定のエラーがないかをログで確認し、デプロイを再試行してください。

S3\_ERROR  
このエラーは、Amazon S3 アーティファクトをダウンロードする場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

S3\_RESOURCE\_NOT\_FOUND  
このエラーは、Amazon S3 オペレーションが 404 エラーを返した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

S3\_BAD\_REQUEST  
このエラーは、Amazon S3 オペレーションが 400 エラーを返した場合に表示されることがあります。特定のエラーがないかをログで確認し、リクエストを再試行してください。

## HTTP エラー
<a name="http-error"></a>

HTTP\_REQUEST\_ERROR  
このエラーは、HTTP リクエストを実行するときにエラーが発生した場合に表示されることがあります。特定のエラーがないかをログで確認してください。

DOWNLOAD\_DEPLOYMENT\_DOCUMENT\_ERROR  
このエラーは、デプロイドキュメントのダウンロード中に HTTP エラーが発生した場合に表示されることがあります。特定の HTTP エラーがないかをログで確認してください。

GET\_GREENGRASS\_ARTIFACT\_SIZE\_ERROR  
このエラーは、パブリックコンポーネントのアーティファクトのサイズを取得するときに HTTP エラーが発生した場合に表示されることがあります。特定の HTTP エラーがないかをログで確認してください。

DOWNLOAD\_GREENGRASS\_ARTIFACT\_ERROR  
このエラーは、パブリックコンポーネントのアーティファクトをダウンロードするときに HTTP エラーが発生した場合に表示されることがあります。特定の HTTP エラーがないかをログで確認してください。

## ネットワークエラー
<a name="network-error"></a>

NETWORK\_ERROR  
このエラーは、デプロイ中に接続の問題が発生した場合に表示されることがあります。デバイスのインターネット接続を確認して、デプロイを再試行してください。

## nucleus エラー
<a name="nucleus-error"></a>

BAD\_REQUEST  
このエラーは、 AWS クラウドオペレーションが 400 エラーを返したときに発生することがあります。ログをチェックしてエラーの原因となった API を確認し、nucleus ソフトウェアの更新ページをチェックして、新しいバージョンの nucleus で問題が修正されたかどうかを確認するか、 にお問い合わせください サポート。

NUCLEUS\_VERSION\_NOT\_FOUND  
このエラーは、コアデバイスがアクティブな nucleus のバージョンを見つけられない場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

NUCLEUS\_RESTART\_FAILURE  
このエラーは、nucleus の再起動を必要とするデプロイ中に nucleus が再起動しない場合に表示されることがあります。ローダーログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

INSTALLED\_COMPONENT\_NOT\_FOUND  
このエラーは、nucleus がインストールされたコンポーネントを見つけられない場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

DEPLOYMENT\_DOCUMENT\_NOT\_VALID  
このエラーは、有効でないデプロイドキュメントをデバイスが受信した場合に表示されることがあります。その他のエラーコードを確認するか、ログでエラーの原因を確認してください。

EMPTY\_DEPLOYMENT\_REQUEST  
このエラーは、デバイスが空のデプロイリクエストを受け取った場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

DEPLOYMENT\_DOCUMENT\_PARSE\_ERROR  
このエラーは、デプロイリクエストの形式が、想定される形式と一致しない場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

COMPONENT\_METADATA\_NOT\_VALID\_IN\_DEPLOYMENT  
このエラーは、デプロイリクエストに有効でないコンポーネントメタデータが含まれている場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

LAUNCH\_DIRECTORY\_CORRUPTED  
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\_ERROR  
このエラーは、 AWS サービスオペレーションが 500 エラーを返したときに発生することがあります。これは、サービスが現在リクエストを処理できないためです。後でデプロイを再試行してください。

S3\_SERVER\_ERROR  
このエラーは、Amazon S3 オペレーションが 500 エラーを返した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

## クラウドサービスのエラー
<a name="cloud-service-error"></a>

RESOLVE\_COMPONENT\_CANDIDATES\_BAD\_RESPONSE  
このエラーは、Greengrass クラウドサービスが `ResolveComponentCandidates` オペレーションに対して互換性のないレスポンスを送信した場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

DEPLOYMENT\_DOCUMENT\_SIZE\_EXCEEDED  
このエラーは、リクエストされたデプロイドキュメントが最大サイズクォータを超えた場合に表示されることがあります。デプロイドキュメントのサイズを小さくして、デプロイを再試行してください。

GREENGRASS\_ARTIFACT\_SIZE\_NOT\_FOUND  
このエラーは、Greengrass がパブリックコンポーネントアーティファクトのサイズを取得できない場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

DEPLOYMENT\_DOCUMENT\_NOT\_VALID  
このエラーは、有効でないデプロイドキュメントをデバイスが受信した場合に表示されることがあります。その他のエラーコードを確認するか、ログでエラーの原因を確認してください。

EMPTY\_DEPLOYMENT\_REQUEST  
このエラーは、デバイスが空のデプロイリクエストを受け取った場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

DEPLOYMENT\_DOCUMENT\_PARSE\_ERROR  
このエラーは、デプロイリクエストの形式が、想定される形式と一致しない場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

COMPONENT\_METADATA\_NOT\_VALID\_IN\_DEPLOYMENT  
このエラーは、デプロイリクエストに有効でないコンポーネントメタデータが含まれている場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

## 一般的なエラー
<a name="generic-error"></a>

これらの一般的なエラーには、関連するエラータイプはありません。

DEPLOYMENT\_INTERRUPTED  
このエラーは、nucleus のシャットダウンや他の外部イベントが原因でデプロイを完了できない場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

ARTIFACT\_DOWNLOAD\_ERROR  
このエラーは、アーティファクトのダウンロード中に問題が発生した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

NO\_AVAILABLE\_COMPONENT\_VERSION  
このエラーは、コンポーネントバージョンがクラウドもしくはローカルに存在しない場合、または依存関係の解決に競合がある場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

COMPONENT\_PACKAGE\_LOADING\_ERROR  
このエラーは、ダウンロードしたアーティファクトの処理中にエラーが発生した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

CLOUD\_API\_ERROR  
このエラーは、 AWS サービス API の呼び出し中にエラーが発生しました。詳細については、その他のエラーコードまたはログを確認してください。

IO\_ERROR  
このエラーは、デプロイ中に I/O エラーが発生した場合に表示されることがあります。詳細については、その他のエラーコードまたはログを確認してください。

COMPONENT\_UPDATE\_ERROR  
このエラーは、デプロイ中にコンポーネントが更新されない場合に表示されることがあります。その他のエラーコードを確認するか、ログでエラーの原因を確認してください。

## 未知のエラー
<a name="unknown-error"></a>

DEPLOYMENT\_FAILURE  
このエラーは、未チェックの例外がスローされたためにデプロイが失敗した場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。

DEPLOYMENT\_TYPE\_NOT\_VALID  
このエラーは、デプロイのタイプが有効でない場合に表示されることがあります。ログでエラーの原因を確認してから、nucleus ソフトウェアの更新ページで nucleus の新しいバージョンで問題が修正されているかどうかを確認するか、 サポートにお問い合わせください。