mgwutil delete-agent コマンドを使用して、指定されたエージェントを対話形式または強制的に削除します。この操作は元に戻せないため、慎重な確認が必要です。 - Data Online Migration

mgwutil delete-agent コマンドを使用すると、指定されたエージェントを対話形式または強制的に削除できます。

重要

この操作は元に戻せません。続行する前に、削除することを確認してください。

コマンドフォーマット

mgwutil delete-agent <agent-name> [--force]

パラメーターの説明

パラメーター	必須	説明
agent-name	はい	削除するエージェントの名前。
--force	いいえ	対話型の確認なしで強制的に削除します。デフォルトでは無効になっています。

例

対話モード

削除コマンドを実行し、プロンプトが表示されたら削除を確認します。これはデフォルトのセーフモードであり、誤削除を防ぐのに役立ちます。

mgwutil delete-agent  mgwutil_agent-12

コマンドを実行すると、削除を確認するための次のプロンプトが表示されます。

please confirm if you want to delete agent: (y/n)

n を入力して Enter キーを押し、操作を中止します。メッセージ cancel the delete agent operation が表示され、削除がキャンセルされたことを示します。
y を入力して Enter キーを押し、削除を確定します。

強制削除 (非対話)

この例では、エージェント mgwutil_agent-12 を強制的に削除する方法を示します。

警告

次のコマンドを使用して、指定されたエージェントを強制的に削除できます。この操作は元に戻せません。注意して実行してください。

mgwutil delete-agent  mgwutil_agent-12 --force

応答

成功応答

{
     "Code": "success" ,
     "StatusCode": 204,
     "LogTime": "2025-12-25 17:51:37",
     "Data":       {}
}

失敗応答

{
  "Code": "fail",
  "StatusCode": 409,
  "LogTime": "2026-01-16 11:24:02",
  "ErrorMsg": "SDKError:    StatusCode: 409    Code: ImportAgentIsOccupied    Message: The import agent is occupied by import address    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****9****69***5.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969AF52F8BE36363969434D','statusCode':409} ",
  "ErrorCode": "ImportAgentIsOccupied",
  "RequestId": "6969AF52F8BE36363969434D"
}

エラーコード

説明

エラーコードはエラーのカテゴリを示します。詳細については、エラーメッセージ (ErrorMsg) をご参照ください。
これらのエラーコードには、共通エラーコードが含まれます。

ErrorCode	説明
CancelOperation	削除操作がキャンセルされました。
InvalidInput	無効な確認入力です。「y」を入力して確定するか、「n」を入力してキャンセルしてください。
ImportAgentIsOccupied	このエージェントは、指定されたデータアドレスにすでに関連付けられています。