批量查询任务进度 - BatchListProgresses

project_id

是

String

参数解释：

租户在某一Region下的Project ID。

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

是

String

参数解释：

发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。

约束限制：

不涉及。

取值范围：

application/json

默认取值：

application/json

X-Auth-Token

是

String

参数解释：

从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Language

否

String

参数解释：

请求语言类型。

约束限制：

不涉及。

取值范围：

• en-us：英语
• zh-cn：中文

默认取值：

en-us

jobs

是

Array of strings

参数解释：

批量查询进度任务ID请求列表，通过该参数指定需要查询进度的一个或多个任务。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

count

Integer

参数解释：

返回的任务进度信息总数，表示本次查询成功返回的任务数量，与results数组的长度一致。

约束限制：

不涉及。

取值范围：

不涉及。

results

Array of objects

参数解释：

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

详情请参见表5。

job_id

String

参数解释：

任务ID，用于唯一标识一个数据复制任务，在查询、修改、删除等操作中作为任务的识别凭证。

约束限制：

不涉及。

取值范围：

不涉及。

progress

String

参数解释：

迁移百分比，表示当前任务的数据迁移完成进度。

约束限制：

当progress为-1时代表任务还未进入迁移。

取值范围：

0-100。

incre_trans_delay

String

参数解释：

增量迁移时延，单位：s。当任务处于增量阶段时，该值表示源库与目标库之间的数据同步延迟。

约束限制：

当incre_trans_delay为-1时代表不处于增量阶段。

取值范围：

不涉及。

incre_trans_delay_millis

String

参数解释：

增量迁移时延，单位：ms。与incre_trans_delay含义相同，但以毫秒为单位提供更精确的时延信息。

约束限制：

当incre_trans_delay_millis为-1时代表不处于增量阶段。

取值范围：

不涉及。

task_mode

String

参数解释：

任务模式，指定数据复制任务的执行方式。

约束限制：

单主灾备场景仅支持选择FULL_INCR_TRANS（全量+增量）。

取值范围：

• FULL_TRANS：全量，仅迁移历史数据，迁移完成后任务结束。
• INCR_TRANS：增量，仅同步新增数据变更，适用于持续同步场景。
• FULL_INCR_TRANS：全量+增量，先迁移历史数据再持续同步增量，适用于平滑切换场景。

transfer_status

String

参数解释：

任务当前传输状态，表示数据迁移任务所处的运行阶段，可用于判断任务是否正常推进。

约束限制：

不涉及。

取值范围：

• CREATING：创建中
• CREATE_FAILED：创建失败
• CONFIGURATION：配置中
• WAITING_FOR_START：等待启动中
• RELEASE_RESOURCE_COMPLETE：已结束
• DELETED：已删除
• INCRE_TRANSFER_STARTED：增量迁移中
• INCRE_TRANSFER_FAILED：增量迁移失败
• FULL_TRANSFER_STARTED：全量迁移中
• FULL_TRANSFER_COMPLETE：全量迁移完成
• PAUSING：暂停中
• FULL_TRANSFER_FAILED：全量迁移失败

process_time

String

参数解释：

迁移时间，格式为毫秒级Unix时间戳，表示任务最近一次进度更新时间。

约束限制：

不涉及。

取值范围：

不涉及。

remaining_time

String

参数解释：

预计剩余时间，单位为秒。

约束限制：

不涉及。

取值范围：

不涉及。

progress_map

Map<String>

参数解释：

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

详情请参见表6。

error_code

String

参数解释：

错误码，当任务报错时返回的错误代码。

约束限制：

不涉及。

取值范围：

格式为DRS.XXXXXX。

error_msg

String

参数解释：

错误信息，当任务执行失败时返回的具体错误描述。

约束限制：

不涉及。

取值范围：

不涉及。

apply_rows_rate

Long

参数解释：

增量迁移RPS。

约束限制：

值为-1时代表任务尚未进入到增量状态。

取值范围：

不涉及。

apply_bytes_rate

Long

参数解释：

增量迁移网络流量。

约束限制：

值为-1时代表任务尚未进入到增量状态。

取值范围：

不涉及。

completed

String

参数解释：

完成进度，以百分比形式表示，如"94%"、"100%"。

约束限制：

不涉及。

取值范围：

不涉及。

remaining_time

String

参数解释：

该子项任务的预计剩余时间。

约束限制：

不涉及。

取值范围：

不涉及。

202

Accepted

400

Bad Request