使用 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	指定的代理不存在，請確認代理名稱輸入無誤且該代理已完成建立。