# 查询租户任务列表 - ShowJobList #### 功能介绍 查询租户任务列表，可以根据引擎类型，网络类型，任务状态，任务名称，任务ID进行查询。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DRS&api=ShowJobList)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。 #### URI POST /v3/{project_id}/jobs 表1路径参数 | **参数** | **是否必选** | **参数类型** | **描述** | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 请求参数 表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灾备。 - **gaussdbv5**：GaussDB同步。 - **mysql** **-to-kafka**：MySQL到Kafka同步。 - **taurus-to-kafka**：TaurusDB到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。 详细取值可参考[引擎类型说明](https://support.huaweicloud.com/api-drs/drs_api_0159.html)。 **默认取值**： 不涉及。 | | 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\ | **参数解释**： 标签信息，用于按标签过滤查询结果，格式为key/value键值对。 详情请参见[表7](https://support.huaweicloud.com/api-drs/drs_03_0104.html#ZH-CN_TOPIC_0000001072603879__request_ResourceTag)。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | 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]。 | 表5jobs字段数据结构说明 | **参数** | **参数类型** | **描述** | |:---|:---|:---| | 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灾备。 - **gaussdbv5**：GaussDB同步。 - **mysql** **-to-kafka**：MySQL到Kafka同步。 - **taurus-to-kafka**：TaurusDB到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。 详细取值可参考[引擎类型说明](https://support.huaweicloud.com/api-drs/drs_api_0159.html)。 | | 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]。 | 表6children字段数据结构说明 | **参数** | **参数类型** | **描述** | |:---|:---|:---| | 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灾备。 - **gaussdbv5**：GaussDB同步。 - **mysql** **-to-kafka**：MySQL到Kafka同步。 - **taurus-to-kafka**：TaurusDB到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。 详细取值可参考[引擎类型说明](https://support.huaweicloud.com/api-drs/drs_api_0159.html)。 | | error_msg | String | **参数解释**： 错误详细信息，当任务执行失败时返回的具体错误描述。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 | | id | String | **参数解释**： 子任务ID，用于唯一标识一个数据复制子任务。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 | | job_direction | String | **参数解释**： 子任务的迁移方向。 **约束限制**： 不涉及。 **取值范围**： - **up** ：入云，灾备场景时对应本云为备**。** - **down**：出云，灾备场景时对应本云为主。 - **non-dbs**：自建。 | | name | String | **参数解释**： 子任务名称，用于标识和区分不同的数据复制子任务。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 | | net_type | String | **参数解释**： 子任务使用的网络类型。 **约束限制**： 不涉及。 **取值范围**： - **vpn**：虚拟专用网络。 - **vpc**：虚拟私有云。 - **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]。 | 表7job_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 | 其他状态请参见[状态码](https://support.huaweicloud.com/api-drs/drs_api_0108.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-drs/drs_05_0004.html)。