更新时间:2026-07-29 GMT+08:00

查询租户任务列表 - ShowJobList

功能介绍

查询租户任务列表,可以根据引擎类型,网络类型,任务状态,任务名称,任务ID进行查询。

调试

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

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

POST /v3/{project_id}/jobs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

租户在某一Region下的Project ID。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

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

表3 请求Body参数

参数

是否必选

参数类型

描述

cur_page

Integer

参数解释

当前页码,用于分页查询时指定返回第几页的数据。填0可获取全部数据项。

约束限制

不涉及。

取值范围

不涉及。

默认取值

1

per_page

Integer

参数解释

每页返回的记录数,用于分页查询时控制每页数据量。

约束限制

不涉及。

取值范围

0-1000。

默认取值

10

db_use_type

String

参数解释

迁移任务的业务场景类型。

约束限制

不涉及。

取值范围

  • migration:实时迁移。
  • sync:实时同步。
  • cloudDataGuard:实时灾备。

默认取值

不涉及。

engine_type

String

参数解释

DRS任务引擎类型。

约束限制

不涉及。

取值范围

  • mysql:MySQL到MySQL迁移,MySQL到MySQL同步。
  • mongodb:MongoDB到DDS迁移与同步。
  • cloudDataGuard-mysql:MySQL到MySQL灾备。
  • gaussdbv5GaussDB同步。
  • mysql-to-kafka:MySQL到Kafka同步。
  • taurus-to-kafkaTaurusDB到Kafka同步。
  • gaussdbv5ha-to-kafka:GaussDB集中式版到Kafka同步。
  • postgresql:PostgreSQL到PostgreSQL同步。
  • oracle-to-gaussdbv5:Oracle-GaussDB 分布式版。
  • oracle-to-gaussdbv5ha:Oracle-GaussDB 集中式版。
  • gaussdbv5-to-oracle:GaussDB 分布式版-Oracle。
  • gaussdbv5ha-to-oracle:GaussDB 集中式版-Oracle。
  • gaussdbv5-to-kafka:GaussDB 分布式版-Kafka。

详细取值可参考引擎类型说明

默认取值

不涉及。

enterprise_project_id

String

参数解释

企业项目ID,用于按企业项目过滤查询结果。

约束限制

  • 不传值时设置为null。
  • 当企业项目开关打开时,可以传值。

取值范围

不涉及。

默认取值

null

name

String

参数解释

任务名称或ID,用于按任务名称或ID过滤查询结果。支持传入多个任务ID,逗号分隔,最多100个。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

net_type

String

参数解释

任务使用的网络类型。

约束限制

不涉及。

取值范围

  • vpn:虚拟专用网络。
  • vpc:虚拟私有云。
  • eip:弹性公网IP。

默认取值

不涉及

service_name

String

参数解释

服务名称,开启EPS(企业项目服务)时使用。

约束限制

不涉及。

取值范围

  • eps:企业项目服务

默认取值

不涉及

status

String

参数解释

任务当前运行状态,用于按任务状态过滤查询结果。

约束限制

不涉及。

取值范围

  • CREATING:创建中。
  • CREATE_FAILED:创建失败。
  • CONFIGURATION:配置中。
  • STARTJOBING:启动中。
  • WAITING_FOR_START:等待启动中。
  • START_JOB_FAILED:启动失败。
  • PAUSING:已暂停。
  • FULL_TRANSFER_STARTED:全量开始,灾备场景下为初始化。
  • FULL_TRANSFER_FAILED:全量失败,灾备场景下为初始化失败。
  • FULL_TRANSFER_COMPLETE:全量完成,灾备场景下为初始化完成。
  • INCRE_TRANSFER_STARTED:增量开始,灾备场景下为灾备中。
  • INCRE_TRANSFER_FAILED:增量失败,灾备场景下为灾备异常。
  • RELEASE_RESOURCE_STARTED:结束任务中。
  • RELEASE_RESOURCE_FAILED:结束任务失败。
  • RELEASE_RESOURCE_COMPLETE:已结束。
  • REBUILD_NODE_STARTED:故障恢复中。
  • REBUILD_NODE_FAILED:故障恢复失败。
  • CHANGE_JOB_STARTED:任务变更中。
  • CHANGE_JOB_FAILED:任务变更失败。
  • DELETED:已删除。
  • CHILD_TRANSFER_STARTING:再编辑子任务启动中。
  • CHILD_TRANSFER_STARTED:再编辑子任务迁移中。
  • CHILD_TRANSFER_COMPLETE:再编辑子任务迁移完成。
  • CHILD_TRANSFER_FAILED:再编辑子任务迁移失败。
  • RELEASE_CHILD_TRANSFER_STARTED:再编辑子任务结束中。
  • RELEASE_CHILD_TRANSFER_COMPLETE:再编辑子任务已结束。
  • NODE_UPGRADE_START:升级开始。
  • NODE_UPGRADE_COMPLETE:升级完成。
  • NODE_UPGRADE_FAILED:升级失败。

默认取值

不涉及

tags

Map<String,String>

参数解释

标签信息,用于按标签过滤查询结果,格式为key/value键值对。

详情请参见表7

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

instance_ids

Array of strings

参数解释

数据库实例ID列表,用于按数据库实例过滤查询结果。

约束限制

最多支持10个实例ID。

取值范围

不涉及。

默认取值

null:表示不使用数据库实例ID过滤

instance_ip

String

参数解释

DRS绑定的数据库实例IP,用于按数据库实例IP过滤查询结果。

约束限制

不涉及。

取值范围

不涉及。

默认取值

空字符串:"",表示不使用DRS绑定数据库IP过滤。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_record

Integer

参数解释

任务总数,表示满足查询条件的任务记录总数量。

约束限制

不涉及。

取值范围

不涉及。

jobs

Array of objects

参数解释

任务信息列表,包含满足查询条件的所有任务详情。

详情请参见表5

表5 jobs字段数据结构说明

参数

参数类型

描述

id

String

参数解释

任务ID,用于唯一标识一个数据复制任务。

约束限制

不涉及。

取值范围

不涉及。

name

String

参数解释

任务名称,用于标识和区分不同的数据复制任务。

约束限制

不涉及。

取值范围

不涉及。

status

String

参数解释

任务当前运行状态。

约束限制

不涉及。

取值范围

  • CREATING:创建中。
  • CREATE_FAILED:创建失败。
  • CONFIGURATION:配置中。
  • STARTJOBING:启动中。
  • WAITING_FOR_START:等待启动中。
  • START_JOB_FAILED:启动失败。
  • PAUSING:已暂停。
  • FULL_TRANSFER_STARTED:全量开始,灾备场景下为初始化。
  • FULL_TRANSFER_FAILED:全量失败,灾备场景下为初始化失败。
  • FULL_TRANSFER_COMPLETE:全量完成,灾备场景下为初始化完成。
  • INCRE_TRANSFER_STARTED:增量开始,灾备场景下为灾备中。
  • INCRE_TRANSFER_FAILED:增量失败,灾备场景下为灾备异常。
  • RELEASE_RESOURCE_STARTED:结束任务中。
  • RELEASE_RESOURCE_FAILED:结束任务失败。
  • RELEASE_RESOURCE_COMPLETE:已结束。
  • REBUILD_NODE_STARTED:故障恢复中。
  • REBUILD_NODE_FAILED:故障恢复失败。
  • CHANGE_JOB_STARTED:任务变更中。
  • CHANGE_JOB_FAILED:任务变更失败。
  • DELETED:已删除。
  • CHILD_TRANSFER_STARTING:再编辑子任务启动中。
  • CHILD_TRANSFER_STARTED:再编辑子任务迁移中。
  • CHILD_TRANSFER_COMPLETE:再编辑子任务迁移完成。
  • CHILD_TRANSFER_FAILED:再编辑子任务迁移失败。
  • RELEASE_CHILD_TRANSFER_STARTED:再编辑子任务结束中。
  • RELEASE_CHILD_TRANSFER_COMPLETE:再编辑子任务已结束。
  • NODE_UPGRADE_START:升级开始。
  • NODE_UPGRADE_COMPLETE:升级完成。
  • NODE_UPGRADE_FAILED:升级失败。

description

String

参数解释

任务的描述信息,用于说明任务用途或备注。

约束限制

不涉及。

取值范围

不涉及。

create_time

String

参数解释

任务创建时间,表示任务首次被创建的时间戳。

约束限制

不涉及。

取值范围

不涉及。

engine_type

String

参数解释

DRS任务引擎类型。

约束限制

不涉及。

取值范围

  • mysql:MySQL到MySQL迁移,MySQL到MySQL同步。
  • mongodb:MongoDB到DDS迁移与同步。
  • cloudDataGuard-mysql:MySQL到MySQL灾备。
  • gaussdbv5GaussDB同步。
  • mysql-to-kafka:MySQL到Kafka同步。
  • taurus-to-kafkaTaurusDB到Kafka同步。
  • gaussdbv5ha-to-kafka:GaussDB集中式版到Kafka同步。
  • postgresql:PostgreSQL到PostgreSQL同步。
  • oracle-to-gaussdbv5:Oracle-GaussDB 分布式版。
  • oracle-to-gaussdbv5ha:Oracle-GaussDB 集中式版。
  • gaussdbv5-to-oracle:GaussDB 分布式版-Oracle。
  • gaussdbv5ha-to-oracle:GaussDB 集中式版-Oracle。
  • gaussdbv5-to-kafka:GaussDB 分布式版-Kafka。

详细取值可参考引擎类型说明

net_type

String

参数解释

任务使用的网络类型。

约束限制

不涉及。

取值范围

  • vpn:虚拟专用网络。
  • vpc:虚拟私有云。
  • eip:弹性公网IP。

billing_tag

Boolean

参数解释

任务的计费模式标识,用于标识该任务当前是否处于计费状态。

约束限制

不涉及。

取值范围

  • true:计费中。

  • false:不计费。

job_direction

String

参数解释

任务的迁移方向。

约束限制

不涉及。

取值范围

  • up:入云,灾备场景时对应本云为备
  • down:出云,灾备场景时对应本云为主。
  • non-dbs:自建。

db_use_type

String

参数解释

任务的业务场景类型。

约束限制

不涉及。

取值范围

  • migration:实时迁移。
  • sync:实时同步。
  • cloudDataGuard:实时灾备。

task_type

String

参数解释

任务迁移模式,指定数据复制任务的执行方式。

约束限制

不涉及。

取值范围

  • FULL_TRANS :全量迁移,仅迁移历史数据。
  • FULL_INCR_TRANS:全量+增量迁移,先迁移历史数据再持续同步增量。
  • INCR_TRANS:增量迁移,仅同步数据变更。

children

Array of objects

参数解释

子任务信息体列表,包含当前任务下的所有子任务详情。

详情请参见表6

node_newFramework

Boolean

参数解释

标识任务是否使用新框架执行。

约束限制

不涉及。

取值范围

  • true:使用新框架。

  • false:使用旧框架。

job_action

Object

参数解释

任务操作命令矩阵,包含当前任务可执行和不可执行的操作命令。

详情请参见表7

表6 children字段数据结构说明

参数

参数类型

描述

billing_tag

Boolean

参数解释

任务的计费模式标识,用于标识该任务当前是否处于计费状态。

约束限制

不涉及。

取值范围

  • true:计费中。

  • false:不计费。

create_time

String

参数解释

子任务创建时间,表示任务首次被创建的时间戳。

约束限制

不涉及。

取值范围

不涉及。

db_use_type

String

参数解释

迁移任务的业务场景类型。

约束限制

不涉及。

取值范围

  • migration:实时迁移。
  • sync:实时同步。
  • cloudDataGuard:实时灾备。

description

String

参数解释

子任务描述信息,用于说明任务用途或备注。

约束限制

不涉及。

取值范围

不涉及。

engine_type

String

参数解释

DRS任务引擎类型。

约束限制

不涉及。

取值范围

  • mysql:MySQL到MySQL迁移,MySQL到MySQL同步。
  • mongodb:MongoDB到DDS迁移与同步。
  • cloudDataGuard-mysql:MySQL到MySQL灾备。
  • gaussdbv5GaussDB同步。
  • mysql-to-kafka:MySQL到Kafka同步。
  • taurus-to-kafkaTaurusDB到Kafka同步。
  • gaussdbv5ha-to-kafka:GaussDB集中式版到Kafka同步。
  • postgresql:PostgreSQL到PostgreSQL同步。
  • oracle-to-gaussdbv5:Oracle-GaussDB 分布式版。
  • oracle-to-gaussdbv5ha:Oracle-GaussDB 集中式版。
  • gaussdbv5-to-oracle:GaussDB 分布式版-Oracle。
  • gaussdbv5ha-to-oracle:GaussDB 集中式版-Oracle。
  • gaussdbv5-to-kafka:GaussDB 分布式版-Kafka。

详细取值可参考引擎类型说明

error_msg

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

id

String

参数解释

子任务ID,用于唯一标识一个数据复制子任务。

约束限制

不涉及。

取值范围

不涉及。

job_direction

String

参数解释

子任务的迁移方向。

约束限制

不涉及。

取值范围

  • up:入云,灾备场景时对应本云为备
  • down:出云,灾备场景时对应本云为主。
  • non-dbs:自建。

name

String

参数解释

子任务名称,用于标识和区分不同的数据复制子任务。

约束限制

不涉及。

取值范围

不涉及。

net_type

String

参数解释

子任务使用的网络类型。

约束限制

不涉及。

取值范围

  • vpc:虚拟专用网络。
  • vpn:虚拟私有云。
  • eip:弹性公网IP。

node_newFramework

Boolean

参数解释

标识子任务是否使用新框架执行。

约束限制

不涉及。

取值范围

  • true:使用新框架。

  • false:使用旧框架。

status

String

参数解释

子任务当前运行状态。

约束限制

不涉及。

取值范围

  • CREATING:创建中。
  • CREATE_FAILED:创建失败。
  • CONFIGURATION:配置中。
  • STARTJOBING:启动中。
  • WAITING_FOR_START:等待启动中。
  • START_JOB_FAILED:启动失败。
  • PAUSING:已暂停。
  • FULL_TRANSFER_STARTED:全量开始,灾备场景下为初始化。
  • FULL_TRANSFER_FAILED:全量失败,灾备场景下为初始化失败。
  • FULL_TRANSFER_COMPLETE:全量完成,灾备场景下为初始化完成。
  • INCRE_TRANSFER_STARTED:增量开始,灾备场景下为灾备中。
  • INCRE_TRANSFER_FAILED:增量失败,灾备场景下为灾备异常。
  • RELEASE_RESOURCE_STARTED:结束任务中。
  • RELEASE_RESOURCE_FAILED:结束任务失败。
  • RELEASE_RESOURCE_COMPLETE:已结束。
  • REBUILD_NODE_STARTED:故障恢复中。
  • REBUILD_NODE_FAILED:故障恢复失败。
  • CHANGE_JOB_STARTED:任务变更中。
  • CHANGE_JOB_FAILED:任务变更失败。
  • DELETED:已删除。
  • CHILD_TRANSFER_STARTING:再编辑子任务启动中。
  • CHILD_TRANSFER_STARTED:再编辑子任务迁移中。
  • CHILD_TRANSFER_COMPLETE:再编辑子任务迁移完成。
  • CHILD_TRANSFER_FAILED:再编辑子任务迁移失败。
  • RELEASE_CHILD_TRANSFER_STARTED:再编辑子任务结束中。
  • RELEASE_CHILD_TRANSFER_COMPLETE:再编辑子任务已结束。
  • NODE_UPGRADE_START:升级开始。
  • NODE_UPGRADE_COMPLETE:升级完成。
  • NODE_UPGRADE_FAILED:升级失败。

task_type

String

参数解释

子任务迁移模式,指定数据复制任务的执行方式。

约束限制

不涉及。

取值范围

  • FULL_TRANS :全量迁移,仅迁移历史数据。
  • FULL_INCR_TRANS:全量+增量迁移,先迁移历史数据再持续同步增量。
  • INCR_TRANS:增量迁移,仅同步数据变更。

job_action

Object

参数解释

子任务操作命令矩阵,包含当前子任务可执行和不可执行的操作命令。

详情请参见表7

表7 job_action字段数据结构说明

参数

参数类型

描述

available_actions

Array of strings

参数解释

任务当前可执行的操作命令集合,表示该任务当前允许进行的操作。

约束限制

不涉及。

取值范围

  • CREATE:创建任务
  • CHOOSE_OBJECT:选择对象
  • PRE_CHECK:预检查
  • CHANGE_MODE:修改任务模式
  • FREE_RESOURCE:释放资源
  • MODIFY_DB_CONFIG:修改数据库配置
  • RESET_DB_PWD:重置数据库密码(源库、目标库)
  • MODIFY_CONFIGURATION:修改任务配置
  • PAUSE:暂停任务
  • START:启动任务
  • CHANGE:修改任务
  • RETRY:重试任务
  • RESET:重置任务
  • DELETE:删除任务
  • QUERY_PRE_CHECK:预检查
  • SWITCH_OVER:容灾倒换
  • START_INCR:CASSANDRA启动增量任务
  • MODIFY_TASK_NUMBER:CASSANDRA修改线程数配置
  • CONTINUE_JOB:oracle-GaussDB分布式:启动失败或者停止的任务
  • STOP_JOB:oracle-GaussDB分布式:停止任务
  • CONTINUE_CAPTURE:oracle-GaussDB分布式:启动抓取
  • STOP_CAPTURE:oracle-GaussDB分布式:停止抓取
  • CONTINUE_APPLY:oracle-GaussDB分布式:启动回放
  • STOP_APPLY:oracle-GaussDB分布式:停止回放
  • PAY_ORDER:包年包月支付订单
  • UNSUBSCRIBE:包年包月退订
  • TO_PERIOD:转包周期
  • TO_RENEW:包周期续费
  • ORDER_INFO:订单详情
  • CHANGE_FLAVOR:规格变更
  • CLONE:克隆任务

unavailable_actions

Array of strings

参数解释

任务当前不可执行的操作命令集合,表示该任务当前不允许进行的操作。

约束限制

不涉及。

取值范围

  • CREATE:创建任务
  • CHOOSE_OBJECT:选择对象
  • PRE_CHECK:预检查
  • CHANGE_MODE:修改任务模式
  • FREE_RESOURCE:释放资源
  • MODIFY_DB_CONFIG:修改数据库配置
  • RESET_DB_PWD:重置数据库密码(源库、目标库)
  • MODIFY_CONFIGURATION:修改任务配置
  • PAUSE:暂停任务
  • START:启动任务
  • CHANGE:修改任务
  • RETRY:重试任务
  • RESET:重置任务
  • DELETE:删除任务
  • QUERY_PRE_CHECK:预检查
  • SWITCH_OVER:容灾倒换
  • START_INCR:CASSANDRA启动增量任务
  • MODIFY_TASK_NUMBER:CASSANDRA修改线程数配置
  • CONTINUE_JOB:oracle-GaussDB分布式:启动失败或者停止的任务
  • STOP_JOB:oracle-GaussDB分布式:停止任务
  • CONTINUE_CAPTURE:oracle-GaussDB分布式:启动抓取
  • STOP_CAPTURE:oracle-GaussDB分布式:停止抓取
  • CONTINUE_APPLY:oracle-GaussDB分布式:启动回放
  • STOP_APPLY:oracle-GaussDB分布式:停止回放
  • PAY_ORDER:包年包月支付订单
  • UNSUBSCRIBE:包年包月退订
  • TO_PERIOD:转包周期
  • TO_RENEW:包周期续费
  • ORDER_INFO:订单详情
  • CHANGE_FLAVOR:规格变更
  • CLONE:克隆任务

current_action

String

参数解释

任务当前正在执行的操作命令。

约束限制

不涉及。

取值范围

  • SWITCH_OVER:灾备倒换中。
  • STOP_JOB:任务暂停中。

请求示例

  • 查询实时同步任务列表示例:
    https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs
    
    {
      "cur_page" : 1,
      "db_use_type" : "sync",
      "engine_type" : "",
      "name" : "",
      "net_type" : "",
      "per_page" : 5,
      "status" : ""
    }
  • 查询实时迁移任务列表示例:
    https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs
    
    {
      "cur_page" : 1,
      "db_use_type" : "migration",
      "engine_type" : "",
      "name" : "",
      "net_type" : "",
      "per_page" : 5,
      "status" : ""
    }
  • 通过数据库实例ID,查询实时同步任务列表示例:
    https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs 
      
     { 
       "cur_page" : 1, 
       "db_use_type" : "sync", 
       "engine_type" : "", 
       "enterprise_project_id" : "", 
       "name" : "", 
       "net_type" : "", 
       "per_page" : 5, 
       "instance_ids" : [ "id1", "id2" ], 
       "status" : "" 
     }
  • 通过数据库实例IP,查询实时同步任务列表示例:
    https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs 
      
     { 
       "cur_page" : 1, 
       "db_use_type" : "sync", 
       "engine_type" : "", 
       "enterprise_project_id" : "", 
       "name" : "", 
       "net_type" : "", 
       "per_page" : 5, 
       "instance_ip" : "127.0.0.1", 
       "status" : "" 
     }
  • 查询实时同步任务列表多个任务ID示例:
    https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs 
      
    {
      "cur_page": 1,
      "db_use_type": "sync",
      "engine_type": "",
      "name": "bee869bc-15c0-4b3b-a34b-bf0d5efjb201,c2a61a77-6e55-4cd8-8be1-a562cc6jb201",
      "net_type": "",
      "per_page": 100,
      "status": ""
    }

响应示例

状态码:200

OK

  • 查询实时迁移任务列表响应示例 :
    {
      "jobs" : [ {
        "id" : "24834eb6-be30-464e-a299-f7aa730jb101",
        "name" : "DRS-3999-lws",
        "status" : "INCRE_TRANSFER_FAILED",
        "description" : "",
        "create_time" : "2020-12-21 10:57:49",
        "error_msg" : "service LOGMANAGER failed, cause by: Unable to connect to DBMS: url=jdbc:mysql://172.22.74.56:3306?useUnicode=true&allowLoadLocalInfile=false&characterEncoding=UTF-8&connectTimeout=5000&useSSL=false&allowPublicKeyRetrieval=true&verifyServerCertificate=false&serverTimezone=UTC user=root",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "up",
        "db_use_type" : "migration",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action":{
            "available_actions": [
                "CREATE",
                "CHOOSE_OBJECT",
                "PRE_CHECK",
                "CHANGE_MODE",
                "FREE_RESOURCE",
                "MODIFY_DB_CONFIG",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "RETRY",
                "RESET",
             ],
             "unavailable_actions": [
                 "START",
                 "CHANGE",
                 "DELETE",
                 "QUERY_PRE_CHECK",
                 "SWITCH_OVER",
                 "MODIFY_SPECIFICATION_ID",
                 "START_INCR",
                 "MODIFY_TASK_NUMBER",
                 "CONTINUE_JOB",
                 "STOP_JOB",
                 "CONTINUE_CAPTURE",
                 "STOP_CAPTURE",
                 "CONTINUE_APPLY",
                 "API_CONFIGURATION_ACTION",
                 "STOP_APPLY",
                 "PAY_ORDER",
                 "UNSUBSCRIBE",
                 "TO_PERIOD",
                 "TO_RENEW",
                 "ORDER_INFO",
                 "CHANGE_FLAVOR",
                 "CLONE"
             ]
        }    
      }, {
        "id" : "140b5236-88ad-43c8-811c-1268453jb101",
        "name" : "DRS-0042-linxiaolu",
        "status" : "CONFIGURATION",
        "description" : "",
        "create_time" : "2020-12-19 16:23:24",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "up",
        "db_use_type" : "migration",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "PRE_CHECK",
                "CHANGE_MODE",
                "FREE_RESOURCE",
                "MODIFY_DB_CONFIG",
                "API_CONFIGURATION_ACTION"
            ],
            "unavailable_actions": [
                "RETRY",
                "RESET",
                "DELETE",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR",
                 "CLONE"
             ]
         }
      }, {
        "id" : "7f8e6f74-72d2-4ddd-bb8f-6c41397jb101",
        "name" : "DRS-0796",
        "status" : "RELEASE_RESOURCE_COMPLETE",
        "description" : "",
        "create_time" : "2020-12-18 10:48:11",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "non-dbs",
        "db_use_type" : "migration",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "DELETE",
                "PRE_CHECK",
                "CHANGE_MODE",
                "MODIFY_DB_CONFIG",
                "CLONE"
            ],
            "unavailable_actions": [
                "FREE_RESOURCE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "RETRY",
                "RESET",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR"
             ]
         }
      }, {
        "id" : "14d88eeb-ee7e-4d30-a46e-a5ec8eajb101",
        "name" : "masj-mysql_migration_down-1",
        "status" : "INCRE_TRANSFER_STARTED",
        "description" : "[using] api test 2\n1. 本接口是用来配置源库/目标库信息的,选表前必须执行\n2. 配置中的任务修改描述信息成功,202 success\n3. 增量迁移中的任务修改描述信息失败,202 failed DRS.M01504\nAnother operation is being performed on the migration task or the migration task is abnormal. Try again later./",
        "create_time" : "2020-12-15 15:43:02",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : true,
        "job_direction" : "down",
        "db_use_type" : "migration",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action":{
            "available_actions": [
                 "CREATE",
                 "CHOOSE_OBJECT",
                 "PRE_CHECK",
                 "CHANGE_MODE",
                 "FREE_RESOURCE",
                 "MODIFY_DB_CONFIG",
                 "RESET_DB_PWD",
                 "MODIFY_CONFIGURATION",
                 "PAUSE",
             ],
            "unavailable_actions": [
                 "START",
                 "RETRY",
                 "RESET",
                 "CHANGE",
                 "DELETE",
                 "QUERY_PRE_CHECK",
                 "SWITCH_OVER",
                 "MODIFY_SPECIFICATION_ID",
                 "START_INCR",
                 "MODIFY_TASK_NUMBER",
                 "CONTINUE_JOB",
                 "STOP_JOB",
                 "CONTINUE_CAPTURE",
                 "STOP_CAPTURE",
                 "CONTINUE_APPLY",
                 "API_CONFIGURATION_ACTION",
                 "STOP_APPLY",
                 "PAY_ORDER",
                 "UNSUBSCRIBE",
                 "TO_PERIOD",
                 "TO_RENEW",
                 "ORDER_INFO",
                 "CHANGE_FLAVOR",
                 "CLONE"
             ]
        }    
      }, {
        "id" : "d54691d2-f105-434d-a75d-809b017jb101",
        "name" : "masj-2-mysql_migration_down",
        "status" : "CONFIGURATION",
        "description" : "[using] api test 2\n1. 本接口是用来配置源库/目标库信息的,选表前必须执行\n2. 配置中的任务修改描述信息成功,202 success\n3. 增量迁移中的任务修改描述信息失败,202 failed DRS.M01504\nAnother operation is being performed on the migration task or the migration task is abnormal. Try again later./",
        "create_time" : "2020-12-14 21:39:07",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "down",
        "db_use_type" : "migration",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "PRE_CHECK",
                "CHANGE_MODE",
                "FREE_RESOURCE",
                "MODIFY_DB_CONFIG",
                "API_CONFIGURATION_ACTION"
            ],
            "unavailable_actions": [
                "RETRY",
                "RESET",
                "DELETE",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR",
                 "CLONE"
             ]
         }
      } ],
      "total_record" : 7
    }
  • 查询实时同步任务列表示例 :
    {
      "jobs" : [ {
        "id" : "7994aac9-0a15-4fdb-bcc5-667f088jb20b",
        "name" : "DRS-8200",
        "status" : "CREATE_FAILED",
        "description" : "",
        "create_time" : "2020-12-21 18:02:36",
        "error_msg" : "system error!",
        "engine_type" : "oracle-to-mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "up",
        "db_use_type" : "sync",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "DELETE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "PRE_CHECK",
                "CHANGE_MODE",
                "MODIFY_DB_CONFIG",
                "API_CONFIGURATION_ACTION"
            ],
            "unavailable_actions": [
                "FREE_RESOURCE",
                "RETRY",
                "RESET",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR",
                 "CLONE"
             ]
         }
      }, {
        "id" : "f463331d-e079-4689-bbef-4553202jb20b",
        "name" : "DRS-1285",
        "status" : "CONFIGURATION",
        "description" : "",
        "create_time" : "2020-12-21 17:19:38",
        "engine_type" : "oracle-to-mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "up",
        "db_use_type" : "sync",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "PRE_CHECK",
                "CHANGE_MODE",
                "FREE_RESOURCE",
                "MODIFY_DB_CONFIG",
                "API_CONFIGURATION_ACTION"
            ],
            "unavailable_actions": [
                "RETRY",
                "RESET",
                "DELETE",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR",
                 "CLONE"
             ]
         }
      }, {
        "id" : "7f13c511-c35b-4f82-92ae-83bcbf0jb201",
        "name" : "DRS-9383",
        "status" : "CONFIGURATION",
        "description" : "",
        "create_time" : "2020-12-21 17:18:44",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "up",
        "db_use_type" : "sync",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "PRE_CHECK",
                "CHANGE_MODE",
                "FREE_RESOURCE",
                "MODIFY_DB_CONFIG",
                "API_CONFIGURATION_ACTION"
            ],
            "unavailable_actions": [
                "RETRY",
                "RESET",
                "DELETE",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR",
                 "CLONE"
             ]
         }
      }, {
        "id" : "7686e879-46a4-4d6b-bda9-5540424jb201",
        "name" : "DRS-9272",
        "status" : "CONFIGURATION",
        "description" : "",
        "create_time" : "2020-12-21 16:53:36",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "up",
        "db_use_type" : "sync",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "PRE_CHECK",
                "CHANGE_MODE",
                "FREE_RESOURCE",
                "MODIFY_DB_CONFIG",
                "API_CONFIGURATION_ACTION"
            ],
            "unavailable_actions": [
                "RETRY",
                "RESET",
                "DELETE",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR",
                 "CLONE"
             ]
         }
      }, {
        "id" : "5b2c2ec8-430e-4de0-937b-9d9547ajb201",
        "name" : "DRS-2899",
        "status" : "RELEASE_RESOURCE_COMPLETE",
        "description" : "",
        "create_time" : "2020-12-21 16:24:24",
        "engine_type" : "mysql",
        "net_type" : "eip",
        "billing_tag" : false,
        "job_direction" : "up",
        "db_use_type" : "sync",
        "task_type" : "FULL_INCR_TRANS",
        "node_newFramework" : false
        "job_action": {
            "available_actions": [
                "CREATE",
                "DELETE",
                "PRE_CHECK",
                "CHANGE_MODE",
                "MODIFY_DB_CONFIG",
                "CLONE"
            ],
            "unavailable_actions": [
                "FREE_RESOURCE",
                "START",
                "CHANGE",
                "CHOOSE_OBJECT",
                "RETRY",
                "RESET",
                "QUERY_PRE_CHECK",
                "SWITCH_OVER",
                "MODIFY_SPECIFICATION_ID",
                "RESET_DB_PWD",
                "MODIFY_CONFIGURATION",
                "PAUSE",
                "JUMP_RETRY",
                "START_INCR",
                "MODIFY_TASK_NUMBER",
                "CONTINUE_JOB",
                "STOP_JOB",
                "CONTINUE_CAPTURE",
                "STOP_CAPTURE",
                "CONTINUE_APPLY",
                "STOP_APPLY",
                "PAY_ORDER",
                "UNSUBSCRIBE",
                "TO_PERIOD",
                "TO_RENEW",
                "ORDER_INFO",
                "CHANGE_FLAVOR"
             ]
         }
      } ],
      "total_record" : 18
    }

状态码

状态码

描述

200

OK

400

Bad Request

其他状态请参见状态码

错误码

请参见错误码