mgwutil list-address 命令用於按時間倒序或分頁查詢資料地址，支援選擇性參數 --marker 和 --count 控制輸出結果。 - Data Online Migration

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	參數名無效或參數值不合法。