Elastic Compute Service:クラウドアシスタントのコマンド結果の確認とトラブルシューティング

エラーコード

エラーメッセージ

推奨事項

InstanceNotRunning

コマンドが発行されたときにインスタンスが実行されていませんでした。

インスタンスが実行中状態であることを確認してください。

InstanceRestarted

コマンドの実行中にインスタンスが再起動されました。

コマンドの実行中にインスタンスを再起動しないでください。

ClientNotRunning

Cloud Assistant Agent が実行されていません。

Cloud Assistant Agent が停止しているか、インストールされていません。エージェントを起動またはインストールしてください：

1. Cloud Assistant Agent のプロセスを確認します：

   • Linux：

     ps -ef | grep aliyun-service

   • Windows：タスクマネージャーで aliyun_assist_service プロセスが存在するかどうかを確認してください。

2. プロセスが存在しない場合は、起動してください：

   • Linux：

     # systemctl をサポートする Linux システムの場合
     systemctl start aliyun.service
     
     # systemctl をサポートしない Linux システムの場合
     /etc/init.d/aliyun-service start

   • Windows：サービスマネージャーで Aliyun Assist Service を起動してください。

ClientNetworkBlocked

インスタンスにネットワーク接続の問題があります。

1. ネットワーク接続を確認してください。インスタンス ID が返された場合、ネットワークは接続されています。

   curl https://{region-id}.axt.aliyun.com/luban/api/instance/instance-id

2. インスタンス ID が返されない場合は、セキュリティグループ、ファイアウォール、DNS、およびルートテーブルを確認してください。Cloud Assistant が次の宛先に到達できるように、内部ネットワーク経由で TCP ポート 443、TCP ポート 80、および UDP ポート 53 でのアウトバウンドトラフィックを許可してください：

   • https://{region-id}.axt.aliyun.com:443/

   • http://100.100.100.200:80/

   • http://aliyun-client-assist-{region-id}.oss-{region-id}-internal.aliyuncs.com

     このドメインの接続をテストすると、OSS バケットはプライベートであり、インストールパッケージファイルのみがパブリック読み取り権限を持っているため、「AccessDenied」 レスポンスが想定されます。このメッセージは接続が成功したことを示します。

SecurityGroupRuleDenied

セキュリティグループのルールが Cloud Assistant サービスへのアクセスを拒否しています。

• ErrorInfo フィールドで拒否されたセキュリティグループ ID と IP を見つけ、ルールを更新してアクセスを許可してください。

• 「Cloud Assistant Agent のネットワーク権限を設定する」をご参照ください。

ClientNotResponse

Cloud Assistant Agent が応答しませんでした。

Cloud Assistant Agent のログを確認してください：

1. Cloud Assistant Agent のログファイルを開いてください。デフォルトパス：

   • Linux：/usr/local/share/aliyun-assist/<Cloud Assistant Agent version>/log/aliyun_assist_main.log

   • Windows：C:\ProgramData\aliyun\assist\<Cloud Assistant Agent version>\log\aliyun_assist_main.log

2. ログでコマンドの InvokeId を検索してください：

   • 見つかった場合は、周囲のエントリで例外 (コマンドが終了したか、その結果が報告されたかなど) を確認してください。

   • 見つからない場合は、コマンドを再実行してください。それでも失敗する場合は、Cloud Assistant Agent を再起動してください：

     • Linux：

       # systemctl をサポートする Linux システムの場合
       systemctl restart aliyun.service
       
       # systemctl をサポートしない Linux システムの場合
       /etc/init.d/aliyun-service restart

     • Windows：サービスマネージャーで Aliyun Assist Service を再起動してください。

ClientNeedUpgrade

指定された機能をサポートするには、Cloud Assistant Agent をアップグレードする必要があります。

• ErrorInfo フィールドで必要な機能と最小バージョンを確認してください。Cloud Assistant Agent をそのバージョン以降にアップグレードしてください。

• 自動更新を有効にするか、手動でアップグレードしてください。「Cloud Assistant Agent の自動更新をアップグレードまたは無効にする」をご参照ください。

ClientNotOnline

Cloud Assistant Agent が Cloud Assistant サーバーに接続されていません。

Cloud Assistant エージェントを再起動します。「Cloud Assistant エージェントを停止およびアンインストールする」をご参照ください。

DeliveryTimeout

Cloud Assistant サーバーがコマンドを Cloud Assistant Agent に送信できませんでした。

コマンドを再実行してください。

ExecutionTimeout

コマンドの実行がタイムアウトしました。

必要に応じてコマンドのタイムアウトを増やしてください。

• コンソールでは、デフォルトの タイムアウト は 60 秒です。必要に応じて増やしてください。

• RunCommand API を呼び出すとき、デフォルトの Timeout は 60 秒です。必要に応じてより大きな値を設定してください。

• CreateCommand API の後に InvokeCommand API を使用する場合、デフォルトの Timeout は 60 秒です。作成時にカスタム値を設定するか、後で ModifyCommand API で更新してください。

ExecutionException

コマンドの実行中に例外が発生しました。

詳細については、ErrorInfo フィールドを確認してください。

ExitCodeNonzero

コマンドはゼロ以外の終了コードで終了しました。

コマンドスクリプトと出力を確認してください。

ClientRestarted

Cloud Assistant Agent が再起動されたため、コマンドは中断されました。

エージェントが再起動した後にコマンドを再実行してください。Cloud Assistant コンソールで、または DescribeCloudAssistantStatus API を呼び出して、エージェントのステータスを確認してください。

InstanceReleased

コマンドの実行中にインスタンスがリリースされました。

ターゲットインスタンスがリリースされたため、コマンドは失敗しました。

DirectoryNotExists

指定された作業ディレクトリがインスタンスに存在しません。

インスタンスに作業ディレクトリを作成してから、コマンドを再実行してください。

エラーコード

エラーメッセージ

解決策

ClientIsUpgrading

Cloud Assistant Agent はアップグレード中です。

アップグレードが完了した後にコマンドを再実行してください。Cloud Assistant コンソールで、または DescribeCloudAssistantStatus API を呼び出して、エージェントのステータスを確認してください。

InstanceDeregistered

マネージドインスタンスは登録解除されています。

マネージドインスタンスが登録解除されているため、コマンドは失敗しました。

InvalidSystemBuiltInParameter

組み込み環境変数が無効です。

組み込み環境変数はサポートされていません。サポートされているパラメーターについては、RunCommand API の CommandContent パラメーターをご参照ください。

DefaultWorkingDirectoryNotAvailable

インスタンスのデフォルトの作業ディレクトリが利用できません。

デフォルトの作業ディレクトリを確認してください：

• Linux：デフォルトでは root ユーザーのホームディレクトリ /root。

• Windows：Cloud Assistant Agent プロセスを含むディレクトリ。例：C:\Windows\System32。

コンソールで、または RunCommand API の WorkingDir パラメーターを使用して、作業ディレクトリを指定することもできます。

CommandNotApplicable

コマンドタイプは指定されたインスタンスに適用できません。

各コマンドタイプは、次のオペレーティングシステムをサポートしています：

• RunBatScript：Windows インスタンス用のバッチ (BAT) コマンド。

• RunPowerShellScript：Windows インスタンス用の PowerShell コマンド。

• RunShellScript：Linux インスタンス用のシェルコマンド。

InvalidCommandText

コマンドの内容が無効です。

コマンドの内容を確認してください。プレーンテキストまたは Base64 でエンコードされた形式が使用できます。

CommandContentDecodeError

コマンドの内容のデコードに失敗しました。

Base64 でエンコードされている場合は、エンコーディングが正しいことを確認してください。

AccountNotExists

指定されたユーザーはインスタンスに存在しません。

コマンドを実行する前に、インスタンスにユーザーを作成してください。

• デフォルトでは、コマンドは Linux ECS インスタンスの root ユーザーとして実行されます。

• デフォルトでは、コマンドは Windows ECS インスタンスの System ユーザーとして実行されます。

コンソールまたは RunCommand API の Username パラメーターを使用して、別のユーザーとしてコマンドを実行することもできます。

エラーコード

エラーメッセージ

解決策

BadCronExpression

cron 式が無効です。

cron 式を修正してください。「クロックベースのスケジューリング」をご参照ください。

CronExpressionExpired

cron 式の有効期限が切れています。スケジュールされたタスクは実行されません。

有効期限が切れていない cron 式を指定してください。

InvalidGMTOffsetForTimezone

cron 式に無効な GMT オフセットタイムゾーンフォーマットが含まれています。

GMT オフセットタイムゾーンのフォーマットを確認してください。

サポートされている範囲：GMT-12:59 から GMT+14:59。分：0-59。時間の先頭にゼロはサポートされていません。

InvalidGMTOffsetHourForTimezone

cron 式の GMT オフセット時間が無効です。

GMT オフセットタイムゾーンの時間値を確認してください。

サポートされている範囲：GMT-12:59 から GMT+14:59。時間の先頭にゼロはサポートされていません。

InvalidGMTOffsetMinuteForTimezone

cron 式の GMT オフセット分が無効です。

GMT オフセットタイムゾーンの分値を確認してください。

有効な値：0 から 59。

TimezoneInformationCorrupt

タイムゾーンファイルが破損しているため、Cloud Assistant Agent はタイムゾーン情報を解析できません。

• Linux：/usr/share/zoneinfo にあるタイムゾーンファイルを確認してください。例：/usr/share/zoneinfo/Asia/Shanghai。

• Windows：レジストリを確認してください。例：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。

InvalidRateExpression

レート式が無効です。

レート式を修正してください。「固定間隔での実行」をご参照ください。

RateFrequencyTooLarge

スケジュールされた実行頻度が高すぎます。

実行頻度は 7 日を超えることはできません。

InvalidAtExpression

タイムスタンプ (at 式) が無効です。

タイムスタンプを修正してください。「指定した時刻に一度だけコマンドを実行する」をご参照ください。

AtExpressionExpired

タイムスタンプ (at 式) の有効期限が切れています。スケジュールされたタスクは実行されません。

有効期限が切れていないタイムスタンプを指定してください。

エラーコード

エラーメッセージ

解決策

InvalidContainerName

コンテナ名が無効です。

名前は文字または数字で始まり、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみを含み、255 文字以下である必要があります。

UnsupportedContainerRuntime

コンテナ ID で指定されたコンテナランタイムはサポートされていません。

docker、containerd、または cri-o ランタイム上の CRI 仕様を通じて Kubernetes によって管理されるコンテナのみがサポートされています。

InvalidContainerId

コンテナ ID が無効です。

コンテナ ID は 64 ビットの 16 進文字列である必要があります。オプションで、プレフィックス (docker://、containerd://、または cri-o://) を追加してランタイムを指定できます。

ContainerConnectFailed

コンテナに接続できません。

コンテナが実行中であるかどうかを確認してください。kubectl または Cloud Assistant Agent を使用してコンテナのステータスを確認してください。State が Running であれば、コンテナは実行中です。「Cloud Assistant を使用してコンテナ内でコマンドを実行する」をご参照ください。

• 実行中の場合は、ランタイムを確認してください。CRI を通じて Kubernetes によって管理される docker、containerd、cri-o ランタイムのみがサポートされています。

• ランタイムが準拠している場合は、コマンドが要件を満たしていることを確認してください。「制限」をご参照ください。

ContainerStateAbnormal

コンテナのステータスが異常です。

コンテナが実行中であることを確認してください。Cloud Assistant は実行中のコンテナでのみコマンドを実行します。kubectl または Cloud Assistant Agent を使用して確認してください。State が Running であれば、コンテナは実行中です。「Cloud Assistant を使用してコンテナ内でコマンドを実行する」をご参照ください。

ContainerNotFound

コンテナが存在しません。

名前または ID でコンテナが存在することを確認してください。

方法 1：kubectl を使用する

kubectl --namespace <specified namespace> describe pod <specified pod>

方法 2：Cloud Assistant Agent を使用する

aliyun-service list-containers --source cri --all

「Cloud Assistant を使用してコンテナ内でコマンドを実行する」をご参照ください。

ContainerNameDuplicated

ノード上の複数のコンテナが同じ名前を共有しているため、ターゲットコンテナを識別できません。

• コンテナ名を指定する場合は、ノード上の他のコンテナが同じ名前を共有していないことを確認してください。

• 代わりにコンテナ ID を使用してください。kubectl または Cloud Assistant Agent で見つけてください。「Cloud Assistant を使用してコンテナ内でコマンドを実行する」をご参照ください。

ContainerNameAndIdNotMatch

指定されたコンテナ ID とコンテナ名が一致しません。

コンテナ ID と名前が同じコンテナを参照していることを確認してください。

エラーコード

エラーメッセージ

解決策

UserOrPasswordInvalid

ユーザー名またはパスワードが正しくありません。

ユーザー名またはパスワードが正しいことを確認してください。「暗号化されたパラメーター」および「Cloud Assistant コマンドを実行するための通常ユーザーを設定する」をご参照ください。

QueryParameterStoreFailed

パラメーター ストアからパラメーターを取得できませんでした。

CloudOps Orchestration Service のパラメーター ストアにパスワードが存在することを確認してください。「暗号化されたパラメーター」をご参照ください。

インスタンスの RAM ロールに必要な権限があることを確認してください。「Windows インスタンスの RAM ロールを設定する」をご参照ください。

InstanceRoleInvalid

RAM ロールがインスタンスにアタッチされていません。

DescribeInstanceRamRole API を呼び出して、RAM ロールがインスタンスにアタッチされているかどうかを確認してください。

エラーコード

エラーメッセージ

解決策

TerminationException

タスクの停止に失敗しました。

ErrorInfo フィールドを確認するか、コマンドを再試行してください。

エラーコード

エラーメッセージ

解決策

FileAlreadyExists

同じ名前のファイルが送信先パスにすでに存在します。

次のいずれかの方法で解決してください：

• 送信先パスから既存のファイルを削除してください。

• 既存のファイルを上書きしてください。

  • 上書き で、ファイルをアップロードするときに上書きを有効にしてください。

  • SendFile API を呼び出すときに、Overwrite パラメーターを true に設定してください。

3. ターゲットインスタンス上の送信先パスまたはファイル名を変更してください。

FileNameInvalid

ファイル名が無効です。

ファイル名が Windows または Linux の命名規則に従っていることを確認してください。

• ファイル名 で、名前が有効であることを確認してください。

• SendFile API を呼び出すときに、Name パラメーターが有効であることを確認してください。

FilePathInvalid

ファイルパスが無効です。

ファイルパスが Windows または Linux のパス規則に従っていることを確認してください。

• ターゲットパス で、パスが有効であることを確認してください。

• SendFile API を呼び出すときに、TargetDir パラメーターが有効なパスを指定していることを確認してください。

FileAuthorityInvalid

ファイルの権限が無効です。

ファイルの権限を調整してください。これは Linux インスタンスにのみ適用され、chmod と同じフォーマットを使用します。

UserGroupNotExists

指定されたユーザーグループはインスタンスに存在しません。

デフォルトグループ：root。Linux インスタンスにユーザーグループを作成してください。

コマンド例：groupadd <groupname>。ここで <groupname> は新しいユーザーグループの名前です。