

# Amazon ECS Exec に関する問題のトラブルシューティング
<a name="ecs-exec-troubleshooting"></a>

ECS Exec の使用時にエラーが発生する理由を診断するトラブルシューティングに関する注意事項を以下に示します。

## Execチェッカーを使用して検証する
<a name="ecs-exec-troubleshooting-checker"></a>

ECS Exec チェッカー スクリプトを使用すると、Amazon ECS クラスターとタスクが ECS Exec 機能を使用するための前提条件を満たしていることを確認および検証できます。ECS Exec チェッカースクリプトは、AWS CLI 環境およびクラスターを両方認証し、お客様に代わってさまざまな API を呼び出すことで、タスクが ECS Exec に対応できるようにします。このツールには、AWS CLIの最新バージョンと`jq`が利用可能であることが必要です。詳細については、GitHub で「[ECS Exec チェッカー](https://github.com/aws-containers/amazon-ecs-exec-checker)」を参照してください。

## `execute-command` 呼び出し時のエラー
<a name="ecs-exec-troubleshooting-general"></a>

`The execute command failed` エラーが発生した場合は、以下の原因が考えられます。
+ タスクに必要なアクセス許可がありません。タスクの起動に使用されるタスク定義にタスク IAM のロールが定義されていること、およびロールに必要なアクセス許可があることを確認します。詳細については、「[ECS Exec のアクセス許可](task-iam-roles.md#ecs-exec-required-iam-permissions)」を参照してください。
+ SSM エージェントがインストールされていないか、実行されていません。
+  Amazon ECS 用のインターフェイス Amazon VPC エンドポイントはありますが、システムマネージャーセッションマネージャー用のエンドポイントはありません。