mgwutil create-agent コマンドを使用して、エージェント名、デプロイメントメソッド、ネットワークタイプ、およびチャネル ID を指定してエージェントを作成します。このコマンドは、操作が成功したかどうかを示す詳細な結果を返します。 - Data Online Migration

mgwutil create-agent コマンドを使用して、エージェント名、デプロイメントメソッド、ネットワークタイプ、およびチャネル ID を指定してエージェントを作成します。このコマンドは、操作が成功したかどうかを示す詳細な結果を返します。

コマンドフォーマット

mgwutil create-agent <agent-name> --deploy-method <value> --agent-endpoint <value> --tunnel-id <value>

パラメーター

パラメーター	必須	説明
agent-name	はい	作成するエージェントの名前。
--deploy-method	はい	デプロイメントメソッド。値は `default` である必要があります。
--agent-endpoint	はい	ネットワークタイプ。有効な値は `vpc` と `public` です。
--tunnel-id	はい	関連付けるチャネルの ID。

例

この例では、エージェントを作成する方法を示します。

mgwutil create-agent mgwutil_agent-12 --deploy-method default --agent-endpoint vpc --tunnel-id **-a591-4f26-9ac2-***

結果

成功応答

{
  "Code": "success",
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data": {
    "AgentName": "mgwutil_agent-12",
    "Version": "***-b334-48de-b7a3-***",
    "CreateTime": "2025-07-15T15:05:45.000Z",
    "TunnelId": "*****-168e-42a3-a156-*****"
  }
}

失敗応答

{
  "Code": "fail",
  "StatusCode": 404,
  "LogTime": "2026-01-16 10:41:23",
  "ErrorMsg": "SDKError:    StatusCode: 404    Code: NoSuchImportTunnel    Message: The specified import tunnel does not exist    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1***0963****4**5.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969A553FBF8043831989B65','statusCode':404} ",
  "ErrorCode": "NoSuchImportTunnel",
  "RequestId": "6969A553FBF8043831989B65"
}

エラーコード

説明

エラーコードはエラータイプを示します。詳細については、`ErrorMsg` パラメーターをご参照ください。
このエラーは、共通エラーコードの 1 つです。

ErrorCode	説明
ImportAgentNumExceed	エージェントの数が上限を超えています。デフォルトの上限は 100 です。
ImportAgentAlreadyExist	指定された名前のエージェントはすでに存在します。
NoSuchImportTunnel	関連付けられたチャネルが存在しません。