mgwutil get-agent コマンドを使用して、ステータス、作成時間、デプロイメントメソッドなどの主要なデータを含む、指定されたエージェントの詳細を照会します。 - Data Online Migration

mgwutil get-agent コマンドを使用して、ステータス、作成時間、デプロイメントメソッドなど、特定のエージェントの詳細を照会します。

コマンドフォーマット

mgwutil get-agent <agent-name>

パラメーター

パラメーター	必須	説明
agent-name	はい	照会するエージェントの名前。

例

次のコマンドを実行して、mgwutil_agent-12 という名前のエージェントの詳細を照会します。

mgwutil get-agent mgwutil_agent-12

応答

成功応答

{
  "Code": "success",
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data": {
    "ActivationKey": "***-ea55-49ff-83a6-***",
    "AgentEndpoint": "vpc",
    "CreateTime": "2025-07-15T15:05:45.000Z",
    "DeployMethod": "default",
    "ModifyTime": "2025-07-15T15:05:45.000Z",
    "Name": "mgwutil_agent-12",
    "Owner": "***",
    "Tags": "",
    "TunnelId": "***-168e-42a3-a156-***",
    "Version": "***-b334-48de-b7a3-***",
    "Status": "Disconnected",
    "AgentIp": "192.168.1.20",
    "AgentVersion": "1.6.0"
  }
}

失敗応答

{
  "Code": "fail",
  "StatusCode": 404,
  "LogTime": "2026-01-16 10:44:06",
  "ErrorMsg": "SDKError:    StatusCode: 404    Code: NoSuchImportAgent    Message: The specified import agent does not exist    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****96****94***.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969A5F6BE5E3435324F252E','statusCode':404} ",
  "ErrorCode": "NoSuchImportAgent",
  "RequestId": "6969A5F6BE5E3435324F252E"
}

エラーコード

説明

エラーコードはエラーの種類を示します。詳細については、エラーメッセージ (ErrorMsg) をご参照ください。
一般的なエラーコードのリストについては、「一般的なエラーコード」をご参照ください。

ErrorCode	説明
NoSuchImportAgent	指定されたエージェントは存在しません。エージェント名が正しいこと、およびエージェントが作成されていることを確認してください。