检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 数据复制服务所提供的接口为REST（Representational State Transfer）风格API。通过使用DRS接口，您可以使用DRS的所有功能，包括创建迁移任务、获取任务详细信息、获取迁移任务列表、删除迁移任务等。 表1 v3接口说明 类型 子类型 说明
API v5（公测中） 资源管理 实例管理 批量异步实例管理 实例数据库对象配置 实例详情 实例操作 对比管理 企业项目管理 数据加工 参数管理 标签管理 权限管理 录制回放 连接管理 配置管理 备份迁移
公共接口管理 批量创建任务 批量测试连接 批量测试连接-集群模式 批量修改任务 批量数据库对象选择 批量预检查 批量查询预检查结果 批量设置任务限速 批量获取数据库参数 修改数据库参数 批量启动任务 批量续传/重试 批量暂停任务 批量结束任务或删除任务 批量修改源库/目标库密码 批量设置definer
如何调用API 构造请求 认证鉴权 返回结果
实例操作 操作指定ID任务 采集数据库位点信息 结束任务 批量操作指定ID任务 批量结束任务 获取指定任务允许操作信息 获取查询数据库位点的结果 任务名称校验 更新增量任务启动位点 上传驱动文件(不再推广） 删除驱动文件(不再推广） 同步驱动文件(不再推广） 查询驱动文件列表(不再推广）
API v3（推荐） 配额 公共接口管理 实时灾备
应用示例 批量查询任务状态 批量查询任务详情 批量启动任务
API v3（不再推广） 公共接口管理 实时迁移管理 实时同步管理 实时灾备管理
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token说明如何调用API，该API可以获取用户的Token，Token可以用于调用其他API时鉴权。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，状态码列表请参见状态码。 对于获取用户Token的接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息
认证鉴权 您可以通过如下方式进行认证鉴权。 Token认证：通过Token认证通用请求。 Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。
状态码 状态码如表1所示： 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。
异常请求结果 异常响应要素说明 表1 异常响应要素说明 名称 参数类型 说明 error_code String 接口响应异常时返回的错误编码，详细错误码描述参考错误码。 error_msg String 接口响应异常时返回的错误描述信息。 响应样例 { "error_code":
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个HTTP状态码。返回的消息体中是具体的错误编码及错误描述信息。 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1
快速入门 任务创建流程 任务创建示例
概述 欢迎使用数据复制服务（Data Replication Service，简称DRS）。数据复制服务是一种易用、稳定、高效、用于数据库在线迁移和数据库实时同步的云服务。数据复制服务是通过创建任务，以任务作为数据库迁移的导向。 您可以使用本文档提供的API对数据复制任务进行相关
使用前必读 概述 调用说明 终端节点 约束限制 基本概念
引擎类型说明 DRS各引擎类型对应取值可参考引擎类型说明。 表1 引擎类型说明 引擎类型（engine_type） 说明 对应源数据库取值（db_type） 对应目标数据库取值（db_type） mysql MySQL到MySQL迁移、MySQL到MySQL同步场景使用。 mysql
附录 异常请求结果 通用请求Http Status Code 错误码 任务状态说明 获取项目ID 获取账号ID 获取任务ID 引擎类型说明 状态码
配额 查询配额 父主题： API v3（推荐）
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
