list-job コマンドは、移行ジョブをリスト表示するために使用します。ジョブを逆時系列順に表示したり、ページングクエリを使用したり、親ジョブ名でフィルターしたりすることが可能です。
コマンドフォーマット
mgwutil list-job [--marker <value>] [--count <value>] [--parent-name <value>] [--text] [--json]パラメーター
パラメーター | 必須/任意 | 説明 |
--marker | 任意 | ページングクエリの開始マーカーです。最初のクエリでは、このパラメーターを指定する必要はありません。 前のクエリ応答で |
--count | 任意 | 1 回のクエリで返すジョブの数を指定します。
|
--parent-name | 任意 | 親ジョブの名前です。このパラメーターを使用して、特定の親ジョブ配下のすべてのサブジョブをクエリします。このパラメーターを指定すると、他のパラメーターは無視され、コマンドは一度にすべてのサブジョブを返します。 |
--text | いいえ | 応答はプレーンテキスト形式で返されます。フォーマットを指定しない場合、応答はデフォルトでプレーンテキスト形式で返されます。 |
--json | いいえ | 応答は JSON 形式で返されます。 |
例
すべてのジョブのリスト表示
デフォルトでは、コマンドはすべてのジョブをプレーンテキスト形式で、逆時系列順 (新しいものから古いものへ) にリスト表示します。
--text パラメーターを追加します。
mgwutil list-job --textパラメーターなしでコマンドを実行します。
mgwutil list-job
成功応答
CreateTime Name Version Status SrcAddress DestAddress ParentVersion 2026-01-21 12:01:42 ****-test-retry-20260121-114234-retry-20260121-120141 87753f47-****-4db2-****-bce22714dd15 IMPORT_JOB_FINISHED ****-test-dest-retry-20260121-114234-retry-20260121-120141 ****-test-src a0cf618c-f524-4372-a115-fb31eef4f29e 2026-01-21 11:42:35 ****-test-retry-20260121-114234 a0cf618c-****-4372-****-fb31eef4f29e IMPORT_JOB_FINISHED ****-test-dest-retry-20260121-114234 ****-test-src 72e542b0-d8ca-4ef6-a4e1-2b0af9c50c64
--json パラメーターを使用して、すべてのジョブを JSON 形式で、逆時系列順 (新しいものから古いものへ) にリスト表示します。
mgwutil list-job --json成功応答
{
"Code": "success",
"StatusCode": 200,
"Data": [
{
"CreateTime": "2026-01-21 12:01:42",
"Name": "****-test-retry-20260121-114234-retry-20260121-120141",
"Version": "87753f47-****-4db2-****-bce22714dd15",
"Status": "IMPORT_JOB_FINISHED",
"SrcAddress": "o****-test-dest-retry-20260121-114234-retry-20260121-120141",
"DestAddress": "****-test-src",
"ParentVersion": "a0cf618c-****-4372-****-fb31eef4f29e"
},
{
"CreateTime": "2026-01-21 11:42:35",
"Name": "****-test-retry-20260121-114234",
"Version": "a0cf618c-****-4372-****-fb31eef4f29e",
"Status": "IMPORT_JOB_FINISHED",
"SrcAddress": "****-test-dest-retry-20260121-114234",
"DestAddress": "o****-test-src",
"ParentVersion": "72e542b0-****-4ef6-****-2b0af9c50c64"
},
{
"CreateTime": "2026-01-21 11:31:56",
"Name": "****-test",
"Version": "72e542b0-****-4ef6-****-2b0af9c50c64",
"Status": "IMPORT_JOB_FINISHED",
"SrcAddress": "****-test-dest",
"DestAddress": "****-test-src",
"ParentVersion": ""
}
],
"LogTime": "2026-01-21 19:19:47"
}ページ単位でのジョブのリスト表示
ジョブの総数が 1 ページに表示できる数を超える場合は、--marker および --count パラメーターを使用してページングクエリを実行できます。
--text パラメーターを追加します。
mgwutil list-job --marker "" --count 2 --textこのパラメーターはデフォルトでは指定されません。
mgwutil list-job --marker "" --count 2成功応答
CreateTime Name Version Status SrcAddress DestAddress ParentVersion
2026-01-21 12:01:42 ****-test-retry-20260121-114234-retry-20260121-120141 87753f47-****-4db2-****-bce22714dd15 IMPORT_JOB_FINISHED ****-test-dest-retry-20260121-114234-retry-20260121-120141 ****-test-src a0cf618c-f524-4372-a115-fb31eef4f29e
2026-01-21 11:42:35 ****-test-retry-20260121-114234 a0cf618c-****-4372-****-fb31eef4f29e IMPORT_JOB_FINISHED ****-test-dest-retry-20260121-114234 ****-test-src 72e542b0-d8ca-4ef6-a4e1-2b0af9c50c64
--json パラメーターを追加します。
mgwutil list-job --marker "" --count 2 --json成功応答
{
"Code": "success",
"StatusCode": 200,
"Data": {
"ImportJob": [
{
"CreateTime": "2025-12-30 11:28:19",
"Name": "2233333",
"Version": "741b0c9b-****-4056-****-4126337820b5",
"Status": "IMPORT_JOB_BEGIN",
"SrcAddress": "oss-oss-1-15-per-mouth-and-sat-sun-9-start-dest",
"DestAddress": "oss-oss-1-15-per-mouth-and-sat-sun-9-start-src",
"ParentVersion": ""
},
{
"CreateTime": "2025-09-26 10:29:21",
"Name": "common-inv-oss-oss-test-****",
"Version": "75074dfa-****-4bc7-****-421cb0155835",
"Status": "IMPORT_JOB_FINISHED",
"SrcAddress": "common-inv-****-oss-src",
"DestAddress": "****-test-common-inv-dest",
"ParentVersion": ""
}
],
"NextMarker": "common-inv-oss-oss-test-****",
"Truncated": true
},
"LogTime": "2026-01-21 19:29:55"
}
失敗時の応答
{
"Code": "fail",
"StatusCode": 400,
"LogTime": "2026-01-18 22:08:01",
"ErrorMsg": "SDKError: StatusCode: 400 Code: InvalidArgument Message: count is less than 0 or exceed maximum Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1***6387****55.cn-hangzhou.mgw.aliyuncs.com','requestId':'696CE941F8BE363534B70D92','statusCode':400} ",
"ErrorCode": "InvalidArgument",
"RequestId": "696CE941F8BE363534B70D92"
}エラーコード
エラーコードはエラーの種類を示します。詳細については、エラーメッセージ (ErrorMsg) をご参照ください。
このエラーコードは、共通エラーコードの 1 つです。
ErrorCode | 説明 |
InvalidArgument | パラメーターが無効か、その値が正しくありません。 |