使用mgwutil get-agent命令查询代理详细信息-在线迁移服务-阿里云

使用 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	指定的代理不存在，请确认代理名称输入无误且该代理已完成创建。