检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
快速入门 任务创建流程 任务创建示例
约束限制 您能创建的数据复制任务的数量与配额有关系，具体请参见服务配额。 目前V3 API接口仅支持MySQL->MySQL迁移和同步，MongoDB->DDS迁移，MySQL->Kafka同步，GaussDB(for MySQL)->Kafka同步，GaussDB->Gauss
项目ID。 调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{endpoint}/v3/projects/”，其中{endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
使用前必读 概述 调用说明 终端节点 约束限制 基本概念
获取任务ID 在调用接口的时候，部分URL中需要填入任务ID，所以需要获取到任务ID。任务ID获取方法如下： 从控制台获取任务ID 登录数据复制服务管理控制台。 在任务管理界面，查看任务ID。 或单击任务名称，在“基本信息”页签，查看当前任务的ID。 图1 基本信息 通过API获取任务ID
异常响应要素说明 表1 异常响应要素说明 名称 参数类型 说明 error_code String 接口响应异常时返回的错误编码，详细错误码描述参考错误码。 error_msg String 接口响应异常时返回的错误描述信息。 响应样例 { "error_code": "DRS
复制服务是通过创建任务，以任务作为数据库迁移的导向。 您可以使用本文档提供的API对数据复制任务进行相关操作，如创建、获取详情、获取列表、删除等。支持的全部操作请参见API概览。 在调用数据复制服务API之前，请确保已经充分了解数据复制服务的相关概念，详细信息请参见产品介绍。 父主题：
调用说明 数据复制服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
状态码 状态码如表1所示： 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。
任务状态说明 表1 任务状态说明 状态值 状态说明 CREATING 创建中。 CREATE_FAILED 创建失败。 CONFIGURATION 配置中。 STARTJOBING 启动中。 WAITING_FOR_START 等待启动中。 START_JOB_FAILED 任务启动失败。
权限策略和授权项 策略及授权项说明 DRS授权分类
任务创建流程 迁移任务创建流程 图1 实时迁移任务创建流程 获取用户token：通过调用IAM服务的API，获取用户的Token。 创建迁移实例：根据需要，创建迁移任务。 查询任务创建进度：查询任务当前具体状态 测试连接：测试与源库和目标库的连接，以便继续进行任务。 更新任务信息
引擎类型说明 DRS各引擎类型对应取值可参考引擎类型说明。 表1 引擎类型说明 引擎类型（engine_type） 说明 对应源数据库取值（db_type） 对应目标数据库取值（db_type） mysql MySQL到MySQL迁移、MySQL到MySQL同步场景使用。 mysql
场景三：批量启动任务 场景描述 本章节指导用户通过调用批量启动任务接口，启动多个配置完成的任务。 操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。 URI格式： /v3/{project_id}/jobs/batch-starting
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 区域指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过
终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。 数据复制服务API当前支持的Region如表1和表2所示，请您根据业务需要选择对应区域的终端节点。 表1 数据复制服务v5 API当前支持的Region 区域名称
细粒度策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作。 如果您要允许或是禁止某个接口的操作权限，请使用细粒度策略。 账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败
DRS授权分类 “√”表示支持，“x”表示暂不支持。 表1 任务功能 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 批量创建任务 POST /v3/{project_id}/jobs/batch-creation
场景一：批量查询任务状态 场景描述 本章节指导用户通过调用批量查询任务状态，查询租户下所有任务状态。 操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。 URI格式： /v3/{project_id}/jobs/batch-status
通用请求Http Status Code 正常 表1 正常返回说明 返回值 说明 200 请求成功。 202 异步请求成功提交（任务执行等）。 异常 表2 异常返回说明 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
