Elastic Compute Service:実行結果とトラブルシューティング

エラーコード

エラーメッセージ

解決策

InstanceNotRunning

タスク作成時にインスタンスが起動していませんでした。

インスタンスが起動していることを確認してください。

InstanceRestarted

タスク実行中にインスタンスが再起動されました。

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

ClientNotRunning

クラウドアシスタントエージェント が実行されていません。

クラウドアシスタントエージェント が停止しているか、インストールされていないため、以下の手順に従って クラウドアシスタントエージェント を起動またはインストールしてください。

1. クラウドアシスタントエージェント のプロセスが実行中かどうかを確認します。

   • 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 および 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 サービスへのアクセスを許可します。

• ルールの設定方法については、「クラウドアシスタントエージェントのネットワーク権限の設定」をご参照ください。

ClientNotResponse

クラウドアシスタントエージェント が応答していません。

この問題を特定するために、クラウドアシスタントエージェント のログを確認します。

1. クラウドアシスタントエージェント のログファイルを開きます。デフォルトのログファイルパスは以下のとおりです。

   • Linux：/usr/local/share/aliyun-assist/<クラウドアシスタントエージェントのバージョン>/log/aliyun_assist_main.log

   • Windows：C:\ProgramData\aliyun\assist\<クラウドアシスタントエージェントのバージョン>\log\aliyun_assist_main.log

2. ログ内でコマンドの実行 ID を検索します。

   • ID が存在する場合、周辺のログエントリを確認して例外を特定します。たとえば、Cloud Assistant コマンドの実行が完了したかどうか、および結果が正常に報告されたかどうかを確認します。

   • ID が存在しない場合、コマンドを再度実行します。引き続き失敗する場合は、クラウドアシスタントエージェント を再起動します。

     • Linux の場合、次のコマンドを実行します。

       # systemctl をサポートする Linux ディストリビューションの場合
       systemctl restart aliyun.service
       
       # systemctl をサポートしない Linux ディストリビューションの場合
       /etc/init.d/aliyun-service restart

     • Windows の場合、[サービス] で Aliyun Assist Service を起動します。

ClientNeedUpgrade

クラウドアシスタントエージェント は、特定の機能をサポートするためにアップグレードする必要があります。

• ErrorInfo フィールドで必要な機能および最低サポートバージョンを確認します。このバージョン以上に クラウドアシスタントエージェント をアップグレードする必要があります。

• クラウドアシスタントエージェント の自動更新を有効にするか、手動で クラウドアシスタントエージェント をアップグレードします。「クラウドアシスタントエージェントのアップグレードまたは自動更新の無効化」をご参照ください。

ClientNotOnline

クラウドアシスタントエージェント がサーバーに接続されていません。

クラウドアシスタントエージェント を再起動します。「クラウドアシスタントエージェントの停止およびアンインストール」をご参照ください。

DeliveryTimeout

Cloud Assistant サービスがタスクを クラウドアシスタントエージェント に送信できませんでした。

コマンドはインスタンスに配信されていません。コマンドを再度実行してください。

ExecutionTimeout

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

コマンドがタイムアウトした場合は、実行タイムアウト値を増加させます。

• コンソールでコマンドを作成して実行する場合、タイムアウト のデフォルト値は 60 秒です。このパラメーターを適切な値に設定してください。

• RunCommand 操作を使用する場合、Timeout パラメーターのデフォルト値は 60 秒です。必要に応じて、より高い値に設定してください。

• CreateCommand 操作を呼び出してコマンドを作成し、その後 InvokeCommand 操作を呼び出して実行する場合、Timeout パラメーターのデフォルト値は 60 秒です。コマンド作成時により高い値を設定するか、後で ModifyCommand 操作を使用して変更できます。

ExecutionException

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

ErrorInfo フィールドで詳細なエラーメッセージを確認します。

ExitCodeNonzero

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

コマンドスクリプトおよびコマンド出力を確認します。

ClientRestarted

クラウドアシスタントエージェントが再起動されたため、タスクが中断されました。

エージェントの再起動後にコマンドを再度実行してください。エージェントのステータスは、クラウドアシスタントコンソールまたは DescribeCloudAssistantStatus 操作を呼び出して確認できます。

InstanceReleased

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

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

DirectoryNotExists

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

インスタンス上で指定された作業ディレクトリを作成し、その後コマンドを実行してください。

エラーコード

エラーメッセージ

推奨される解決策

ClientIsUpgrading

クラウドアシスタントエージェントがアップグレード中です。

アップグレードが完了した後にコマンドを再度実行してください。クラウドアシスタントエージェントのステータスは、クラウドアシスタントコンソールまたは DescribeCloudAssistantStatus 操作を呼び出して確認できます。

InstanceDeregistered

管理対象のインスタンスが登録解除されています。

登録解除された管理対象のインスタンスではコマンドを実行できません。

InvalidSystemBuiltInParameter

組み込み環境パラメーターが無効です。

指定された組み込み環境パラメーターはサポートされていません。組み込み環境パラメーターの詳細については、「RunCommand」の CommandContent パラメーターの説明をご参照ください。

DefaultWorkingDirectoryNotAvailable

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

インスタンス上のデフォルト作業ディレクトリを確認します：

• Linux インスタンスの場合、デフォルトディレクトリは root ユーザーのホームディレクトリ（/root）です。

• Windows インスタンスの場合、デフォルトディレクトリはクラウドアシスタントエージェントプロセスの場所（通常は C:\Windows\System32）です。

また、コマンドを実行する際に作業ディレクトリを指定することもできます。クラウドアシスタントコンソールまたは RunCommand 操作の WorkingDir パラメーターで指定できます。

CommandNotApplicable

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

各コマンドタイプがサポートするオペレーティングシステムは以下のとおりです：

• RunBatScript：Windows インスタンス向けのバッチ（BAT）コマンド。

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

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

InvalidCommandText

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

コマンドの内容を確認してください。内容はプレーンテキストまたは Base64 エンコード形式のいずれかになります。

CommandContentDecodeError

コマンドの内容をデコードできませんでした。

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

AccountNotExists

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

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

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

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

また、別の既存のユーザーを指定してコマンドを実行することもできます。クラウドアシスタントコンソールまたは RunCommand 操作の Username パラメーターで指定できます。

エラーコード

エラーメッセージ

解決策

BadCronExpression

指定された cron 式が無効です。

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

CronExpressionExpired

cron 式が期限切れです。対応する定期タスクは実行されません。

コマンドを実行する際に期限切れの cron 式を指定しないでください。

InvalidGMTOffsetForTimezone

cron 式で指定された GMT オフセットタイムゾーンの形式が無効です。

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

サポートされる GMT 範囲は GMT-12:59 ～ GMT+14:59 です。分の値は 0 ～ 59 の整数である必要があります。時間の先行ゼロは使用しないでください。

InvalidGMTOffsetHourForTimezone

cron 式で指定された GMT オフセット時間の値が無効です。

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

サポートされる GMT 範囲は GMT-12:59 ～ GMT+14:59 です。時間の先行ゼロは使用しないでください。

InvalidGMTOffsetMinuteForTimezone

cron 式で指定された GMT オフセット分の値が無効です。

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

分の値は 0 ～ 59 の整数である必要があります。

TimezoneInformationCorrupt

クラウドアシスタントエージェントがタイムゾーン情報を解析できません。この障害は、タイムゾーンファイルの破損やその他の問題が原因である可能性があります。

• Linux インスタンスの場合、/usr/share/zoneinfo ディレクトリに該当するタイムゾーンファイルが存在することを確認してください。たとえば、Asia/Shanghai タイムゾーンのファイルは /usr/share/zoneinfo/Asia/Shanghai です。

• Windows インスタンスの場合、レジストリの HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones に該当するタイムゾーン情報が存在することを確認してください。

InvalidRateExpression

rate 式が無効です。

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

RateFrequencyTooLarge

rate 式で指定された実行間隔が長すぎます。

実行間隔は 7 日を超えてはなりません。

InvalidAtExpression

タイムスタンプ（at 式）が無効です。

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

AtExpressionExpired

タイムスタンプ（at 式）が期限切れです。対応する定期タスクは実行されません。

コマンドを実行する際に期限切れのタイムスタンプを指定しないでください。

エラーコード

エラーメッセージ

解決策

InvalidContainerName

コンテナ名が無効です。

コンテナ名は英字または数字で始まり、英字、数字、ピリオド（.）、アンダースコア（_）、ハイフン（-）のみを含むことができます。名前の長さは最大 255 文字です。

UnsupportedContainerRuntime

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

Cloud Assistant は、docker、containerd、または cri-o コンテナランタイムを使用する CRI 管理コンテナのみをサポートしています。

InvalidContainerId

コンテナ ID が無効です。

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

ContainerConnectFailed

コンテナへの接続に失敗しました。

コンテナが実行中であることを確認してください。kubectl またはクラウドアシスタントエージェントを使用してコンテナの状態を確認できます。State が Running である場合、コンテナは実行中です。「Cloud Assistant を使用したコンテナ内でのコマンド実行」をご参照ください。

• コンテナが実行中の場合、そのコンテナランタイムを確認してください。Cloud Assistant は、docker、containerd、または cri-o コンテナランタイムを使用する CRI 管理コンテナのみをサポートしています。

• コンテナランタイムがサポートされている場合、コマンドが記載されている 使用制限 を遵守していることを確認してください。

ContainerStateAbnormal

コンテナの状態が異常です。

Cloud Assistant は、実行中のコンテナでのみコマンドを実行できます。コンテナの状態を kubectl またはクラウドアシスタントエージェントで確認してください。State が Running である場合、コンテナは実行中です。「Cloud Assistant を使用したコンテナ内でのコマンド実行」をご参照ください。

ContainerNotFound

コンテナが見つかりませんでした。

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

方法 1：kubectl を使用

kubectl --namespace <namespace> describe pod <pod-name>

方法 2：クラウドアシスタントエージェントを使用

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

詳細については、「Cloud Assistant を使用したコンテナ内でのコマンド実行」をご参照ください。

ContainerNameDuplicated

ノード上に同じ名前の複数のコンテナが存在します。ターゲットコンテナを特定できません。

• コンテナ名でコマンドを実行する場合、ノード上で名前が一意であることを確認してください。

• コンテナ ID を指定してコマンドを実行してください。kubectl またはクラウドアシスタントエージェントを使用してコンテナ ID を特定できます。「Cloud Assistant を使用したコンテナ内でのコマンド実行」をご参照ください。

ContainerNameAndIdNotMatch

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

コンテナ ID とコンテナ名が正しいことを確認してください。

エラーコード

エラーメッセージ

解決策

UserOrPasswordInvalid

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

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

QueryParameterStoreFailed

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

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

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

InstanceRoleInvalid

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

DescribeInstanceRamRole 操作を呼び出して、インスタンスに RAM ロールがアタッチされていることを確認してください。

エラーコード

エラーメッセージ

推奨事項

TerminationException

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

ErrorInfo フィールドで詳細なエラーメッセージを確認するか、タスクの停止を再度試行してください。

エラーコード

エラーメッセージ

推奨事項

FileAlreadyExists

宛先パスに同名のファイルがすでに存在します。

この問題を解決するには、以下のいずれかの方法を実行してください：

• パスから既存のファイルを削除します。

• 既存のファイルを上書き可能にします。

  • クラウドアシスタントコンソールでは、ファイルをアップロードする際に 上書き を有効にします。

  • OpenAPI： SendFile 操作を呼び出す際に、Overwrite パラメーターを true に設定します。

ターゲットインスタンス上のファイル名または宛先パスを変更します。

FileNameInvalid

ファイル名が無効です。

ファイル名を Windows または Linux オペレーティングシステムの命名規則に準拠するように変更してください。

• クラウドアシスタントコンソールでは、ファイルをアップロードする際に ファイル名 が要件を満たしていることを確認してください。

• OpenAPI： SendFile 操作を呼び出す際に、Name パラメーターが要件を満たしていることを確認してください。

FilePathInvalid

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

ファイルパスを Windows または Linux オペレーティングシステムのパス規則に準拠するように変更してください。

• クラウドアシスタントコンソールでは、ファイルをアップロードする際に 宛先パス がファイルパスの要件を満たしていることを確認してください。

• OpenAPI： SendFile 操作を呼び出す際に、TargetDir パラメーターが有効なパスに設定されていることを確認してください。

FileAuthorityInvalid

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

ファイルの権限を変更してください。この設定は Linux インスタンスにのみ適用され、chmod コマンドと同じ形式を使用します。

UserGroupNotExists

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

デフォルトのユーザーグループは root です。異なるグループを指定した場合、Linux インスタンス上でそのグループを作成する必要があります。

例：groupadd <groupname>（<groupname> は作成するユーザーグループの名前）