更新时间:2023-11-22 GMT+08:00

批量查询任务进度

功能介绍

根据任务ID批量查询全量进度、增量时延信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v3/{project_id}/jobs/batch-progress

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的Project ID。

获取方法请参见获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

指定类型为application/json。

缺省值:application/json

X-Auth-Token

String

从IAM服务获取的用户Token。

X-Language

String

请求语言类型。

缺省值:en-us

取值:

  • en-us
  • zh-cn
表3 请求Body参数

参数

是否必选

参数类型

描述

jobs

Array of strings

批量查询进度任务ID请求列表。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

count

Integer

总数。

results

Array of objects

批量查询迁移进度的响应体集合。

详情请参见表5

表5 results字段数据结构说明

参数

参数类型

描述

job_id

String

任务ID。

progress

String

迁移百分比。

incre_trans_delay

String

增量迁移时延,单位:s。

incre_trans_delay_millis

String

增量迁移时延,单位:ms。

task_mode

String

任务模式。取值:

  • FULL_TRANS:全量。
  • INCR_TRANS:增量。
  • FULL_INCR_TRANS:全量+增量。

    单主灾备场景仅支持选择全量加增量(FULL_INCR_TRANS)。

transfer_status

String

任务状态。

process_time

String

迁移时间,时间戳。

remaining_time

String

预计剩余时间。

progress_map

Map<String,ProgressInfo>

数据,结构,索引迁移进度信息体。

详情请参见表6

error_code

String

错误码。

error_msg

String

错误信息。

表6 progress_map字段数据结构说明

参数

参数类型

描述

completed

String

完成进度。

remaining_time

String

预计剩余时间。

请求示例

查询灾备进度示例:

https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-progress

{
  "jobs" : [ "8d0e8e36-a618-490d-8a46-8c61ac9jb502" ]
}

响应示例

状态码: 200

OK

  • 查询灾备进度响应示例 1:
    {
      "count" : 1,
      "results" : [ {
        "progress" : "100",
        "job_id" : "8d0e8e36-a618-490d-8a46-8c61ac9jb502",
        "incre_trans_delay" : "0",
        "task_mode" : "FULL_INCR_TRANS",
        "transfer_status" : "INCRE_TRANSFER_STARTED",
        "process_time" : "1608274919000",
        "remaining_time" : "0"
      } ]
    }
  • 查询灾备进度响应示例 2:
    {
      "count" : 2,
      "results" : [ {
        "progress" : "100",
        "job_id" : "edae91cb-5892-49b6-a529-4921fb26jb21",
        "incre_trans_delay" : "0",
        "task_mode" : "FULL_INCR_TRANS",
        "transfer_status" : "INCRE_TRANSFER_STARTED",
        "process_time" : "1594864576000",
        "remaining_time" : "10"
      }, {
        "progress" : "0",
        "job_id" : "f95c5d83-d0c9-42bd-b295-38c31cd1jb15",
        "incre_trans_delay" : "-1",
        "task_mode" : "FULL_INCR_TRANS",
        "transfer_status" : "FULL_TRANSFER_COMPLETE",
        "process_time" : "0",
        "remaining_time" : "0",
        "progress_map" : {
          "struct" : {
            "completed" : "94%",
            "remaining_time" : null
          },
          "data" : {
            "completed" : "100%",
            "remaining_time" : null
          },
          "index" : {
            "completed" : "100%",
            "remaining_time" : null
          }
        }
      } ]
    }

状态码

状态码

描述

202

Accepted

400

Bad Request

错误码

请参见错误码