mgwutil get-job コマンドは、ジョブ名または ID でジョブ詳細をクエリします。オプションのバージョンパラメーターをサポートし、ジョブの構成とステータスに関する詳細情報を返します。 - Data Online Migration

mgwutil get-job コマンドを使用すると、特定のジョブの詳細をクエリできます。

コマンドフォーマット

mgwutil get-job コマンドは、ジョブ名またはジョブ ID によるクエリをサポートしています。

ジョブ名によるクエリ
```
mgwutil get-job <job_name>
```

ジョブ ID によるクエリ

mgwutil get-job <job_version_id> --by-version

パラメーター

パラメーター	必須	説明
job_name	はい	クエリ対象のジョブの名前。このパラメーターまたは `<job_version_id>` のいずれかを指定する必要があります。
job_version_id	はい	クエリ対象のジョブの ID。このパラメーターまたは `<job_name>` のいずれかを指定する必要があります。このパラメーターは `--by-version` パラメーターと一緒に使用する必要があります。
--by-version	いいえ	フラグパラメーターです。このパラメーターを指定すると、最初のパラメーターはジョブ名ではなくジョブ ID として扱われます。

使用例

ジョブ名によるクエリ

次のコマンドは、mgwutil-shell-job-1 という名前のジョブの詳細をクエリします。

mgwutil get-job mgwutil-shell-job-1

ジョブ ID によるクエリ

次のコマンドは、ID が ***-cb16-49d8-a9a8-*** のジョブの詳細をクエリします。

mgwutil get-job ***-cb16-49d8-a9a8-***4 --by-version

返された結果

成功時のレスポンス

{
    "Code": "success",
    "StatusCode": 200,
    "LogTime": "2024-10-15 17:51:37",
    "Data": {
        "Audit": {
            "LogMode": "off"
        },
        "ConvertSymlinkTarget": false,
        "CreateReport": false,
        "CreateTime": "2024-10-15T04:02:21.000Z",
        "DestAddress": "mgwutil_shell_address_dest",
        "EnableMultiVersioning": false,
        "FilterRule": {
            "FileTypeFilters": {
                "ExcludeDir": false,
                "ExcludeSymlink": false
            },
            "KeyFilters": {
                "Excludes": {},
                "Includes": {}
            },
            "LastModifiedFilters": {
                "Excludes": {},
                "Includes": {}
            }
        },
        "ImportQos": {
            "MaxBandWidth": 1073741824,
            "MaxImportTaskQps": 1000
        },
        "ModifyTime": "2024-10-15T06:07:02.000Z",
        "Name": "mgwutil_shell_job",
        "OverwriteMode": "always",
        "Owner": "1445**********34322",
        "ParentName": "",
        "ParentVersion": "",
        "ScheduleRule": {
            "MaxScheduleCount": 1,
            "StartCronExpression": "",
            "SuspendCronExpression": ""
        },
        "SrcAddress": "mgwutil_shell_address_src",
        "Status": "IMPORT_JOB_DOING",
        "Tags": "",
        "TransferMode": "lastmodified",
        "Version": "d8a9b16c-cb16-49d8-a9a8-fedcba987654"
    }
}

失敗時のレスポンス

{
  "Code": "fail",
  "StatusCode": 404,
  "LogTime": "2026-01-16 13:59:25",
  "ErrorMsg": "SDKError:    StatusCode: 404    Code: NoSuchImportJob    Message: The specified import job does not exist    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****96****94***.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969D3BD5CCFC933302EC1A4','statusCode':404} ",
  "ErrorCode": "NoSuchImportJob",
  "RequestId": "6969D3BD5CCFC933302EC1A4"
}

エラーコード

説明

エラーコードはエラーの種類を示します。詳細については、エラーメッセージ (ErrorMsg) をご参照ください。
このエラーコードには、共通エラーコードが含まれます。

エラーコード	説明
NoSuchImportJob	指定されたジョブは存在しません。ジョブ名が正しいこと、およびジョブが作成済みであることを確認してください。