mgwutil list-address 命令用于按时间倒序或分页查询数据地址，支持可选参数 --marker 和 --count 控制输出结果。 - 在线迁移服务

mgwutil list-address 命令用于列举数据迁移服务中已创建的数据地址配置，支持按创建时间倒序排序，并通过 marker 和 count 参数分页查询。

命令格式

mgwutil list-address [--marker <value>] [--count <value>] [--text] [--json]

参数说明

参数	必填	说明
--marker	否	分页查询的起始标记。其值来源于上一次查询返回结果中的 `NextMarker` 字段。首次查询时，可省略该参数。
--count	否	单次请求返回的最大记录数。
--text	否	响应内容将以纯文本（Text）格式返回。不填结果默认采用纯文本格式返回。
--json	否	响应内容将以JSON格式返回。

使用示例

列举数据地址

执行命令时，默认使用 --text 文本格式按创建时间倒序（从最新到最早）列出所有数据地址。
- 加入 --text 参数。
```
mgwutil list-address --text
```
- 不加参数。
```
mgwutil list-address
```

成功返回

CreateTime                      Name                                                            Version                                 Status          AddressType     DataType   AgentList                                                                                
2025-05-20 18:24:09        test_***_src_all__***__ossinv_oss_sa                   66134809-_***_-42e5-_***_-573f4393cfe3    available       ossinv          ossinv                                                                                              
2025-05-20 18:23:09        test__***__src_all__***__ossinv_oss_da                   f71d0e8e-_***_-4eae-_***_-9fa3b78de25e    available       oss             oss                                                                                                 
2025-05-20 18:22:09        test__***__src_big__***__ossinv_oss_da                     0ee700b5-_***_-4ada-_***_-fd3364c6937b    available       oss             oss                                                                                                 
2025-05-20 18:21:09        test__***__src_big__***__ossinv_oss_sa                     e1f4cbac-_***_-4102-_***_-a318433f559d    available       ossinv          ossinv

执行命令时，使用 --json JSON格式按创建时间倒序（从最新到最早）列出所有数据地址。

mgwutil list-address --json

成功返回

{
  "Code": "success",
  "StatusCode": 200,
  "Data": [
    {
      "CreateTime": "2026-01-21 12:01:41",
      "Name": "****-test-dest-retry-20260121-114234-retry-20260121-120141",
      "Version": "80b4266a-****-4a03-****-b7fb23a387bb",
      "Status": "available",
      "AddressType": "ossinv",
      "DataType": "",
      "AgentList": ""
    },
    {
      "CreateTime": "2026-01-21 11:42:34",
      "Name": "****-test-dest-retry-20260121-114234",
      "Version": "571377a9-****-44c4-****-e7fd550bc064",
      "Status": "available",
      "AddressType": "ossinv",
      "DataType": "",
      "AgentList": ""
    }
  ],
  "LogTime": "2026-01-21 18:28:55"
}

分页查询数据地址

当数据地址总数超过单页数量时，可通过 --marker 和 --count 参数进行分页查询。

加入 --text 参数。

mgwutil list-address --marker "" --count 2 --text

默认不加参数。

mgwutil list-address --marker "" --count 2

成功返回

CreateTime              Name                    Version                                 Status          AddressType     DataType        AgentList
2025-09-26 10:19:29     common-inv-***-oss-src  6b12b7b7-***-43c8-***-617984521e1a    available       inv             oss                      
2025-08-15 14:21:26     agent2-test-***-low   f15ec331-***-47b4-***-5dd7e754ee5b    available       oss

加入 --json 参数。

mgwutil list-tunnel --marker "" --count 2 --json

成功返回

{
  "Code": "success",
  "StatusCode": 200,
  "Data": {
    "ImportTunnel": [
      {
        "CreateTime": "2025-09-26 10:19:29",
        "Name": "common-inv-****-oss-src",
        "Version": "6b12b7b7-****-43c8-****-617984521e1a",
        "Status": "available",
        "AddressType": "inv",
        "DataType": "oss",
        "AgentList": ""
      },
      {
        "CreateTime": "2025-08-15 14:21:26",
        "Name": "agent2-test-****-low",
        "Version": "f15ec331-****-47b4-****-5dd7e754ee5b",
        "Status": "available",
        "AddressType": "oss",
        "DataType": "",
        "AgentList": ""
      }
    ],
    "NextMarker": "common-inv-***-oss-src",
    "Truncated": true
  },
  "LogTime": "2026-01-21 19:04:22"
}

失败返回

{
  "Code": "fail",
  "StatusCode": 400,
  "LogTime": "2026-01-18 22:43:08",
  "ErrorMsg": "SDKError:    StatusCode: 400    Code: InvalidArgument    Message: count is less than 0 or exceed maximum    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1147096387694355.cn-hangzhou.mgw.aliyuncs.com','requestId':'696CF17C936706343068128C','statusCode':400} ",
  "ErrorCode": "InvalidArgument",
  "RequestId": "696CF17C936706343068128C"
}

错误码

说明

错误码表示错误类别，详情请参考错误信息（ErrorMsg）。
此错误码包含通用错误码。

ErrorCode	说明
InvalidAugument	参数名无效或参数值不合法。