检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
目前V5 API接口仅支持Redis->GeminiDB Redis迁移、Redis集群->GeminiDB Redis迁移、MySQL->MySQL同步、Oracle->GaussDB分布式版同步场景，请谨慎使用。 父主题： 使用前必读
状态码 状态码如表1所示： 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP
引擎类型说明 DRS各引擎类型对应取值可参考引擎类型说明。 表1 引擎类型说明 引擎类型（engine_type） 说明 对应源数据库取值（db_type） 对应目标数据库取值（db_type） mysql MySQL到MySQL迁移、MySQL到MySQL同步场景使用。 mysql
任务状态说明 表1 任务状态说明 状态值 状态说明 CREATING 创建中。 CREATE_FAILED 创建失败。 CONFIGURATION 配置中。 STARTJOBING 启动中。 WAITING_FOR_START 等待启动中。 START_JOB_FAILED 任务启动失败
任务创建示例 本小节以创建实时迁移任务为示例，介绍如何通过调用API创建任务。 涉及API IAM获取Token的API。 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 注册并登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面的项目列表中查看账号ID。
图1 基本信息 通过API获取任务ID 任务ID还可通过调用批量创建任务API创建任务后获取。 创建任务成功后，响应示例如下，其中的“id”即为任务ID。
任务创建流程 迁移任务创建流程 图1 实时迁移任务创建流程 获取用户token：通过调用IAM服务的API，获取用户的Token。 创建迁移实例：根据需要，创建迁移任务。 查询任务创建进度：查询任务当前具体状态 测试连接：测试与源库和目标库的连接，以便继续进行任务。
调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{endpoint}/v3/projects/”，其中{endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
异常请求结果 异常响应要素说明 表1 异常响应要素说明 名称 参数类型 说明 error_code String 接口响应异常时返回的错误编码，详细错误码描述参考错误码。 error_msg String 接口响应异常时返回的错误描述信息。
通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 区域指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。
操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。
通用请求Http Status Code 正常 表1 正常返回说明 返回值 说明 200 请求成功。 202 异步请求成功提交（任务执行等）。 异常 表2 异常返回说明 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。 数据复制服务API当前支持的Region如表1和表2所示，请您根据业务需要选择对应区域的终端节点。
操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。
场景三：批量启动任务 场景描述 本章节指导用户通过调用批量启动任务接口，启动多个配置完成的任务。 操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。
表1 任务功能 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 批量创建任务 POST /v3/{project_id}/jobs/batch-creation drs:migrationJobs:create
细粒度策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作。 如果您要允许或是禁止某个接口的操作权限，请使用细粒度策略。 账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。
资源规划 表1 资源规划 类别 子类 规划 备注 源端VPC VPC名称 vpc-DRSsrc 自定义，易理解可识别。 所属Region 华南-广州 选择和自己业务区最近的Region，减少网络时延。 可用区 可用区二 - 子网网段 10.0.0.0/24 子网选择时建议预留足够的网络资源
SDK接口 SDK接口介绍 SDK使用说明 SDK下载地址
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
