mgwutil list-address コマンドは、データ移行サービスのデータアドレス構成をリスト表示します。結果は作成時間の逆時系列順にソートされます。このコマンドは、marker と count パラメーターを使用したページングクエリもサポートしています。
コマンドフォーマット
mgwutil list-address [--marker <value>] [--count <value>] [--text] [--json]パラメーター
パラメーター | 必須 | 説明 |
--marker | いいえ | ページングクエリの開始マーカーです。この値は、前のクエリの応答に含まれる |
--count | いいえ | 1 回のリクエストで返されるレコードの最大数です。 |
--text | いいえ | 応答をプレーンテキスト形式で返します。このパラメーターを省略した場合、応答はデフォルトでプレーンテキスト形式になります。 |
--json | いいえ | 応答を JSON 形式で返します。 |
例
データアドレスのリスト
デフォルトでは、コマンドはすべてのデータアドレスをプレーンテキスト形式で、新しいものから古いものへの逆時系列順にリスト表示します。
--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) をご参照ください。
このエラーコードは、共通エラーコード の 1 つです。
ErrorCode | 説明 |
InvalidArgument | パラメーター名が無効か、パラメーター値が有効ではありません。 |