检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本小节以创建实时迁移任务为示例，介绍如何通过调用API创建任务。 涉及API IAM获取Token的API。 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 创建DRS实时迁移任务的API。 具体步骤 Token认
任务状态说明 表1 任务状态说明 状态值 状态说明 CREATING 创建中。 CREATE_FAILED 创建失败。 CONFIGURATION 配置中。 STARTJOBING 启动中。 WAITING_FOR_START 等待启动中。 START_JOB_FAILED 任务启动失败。
权限策略和授权项 策略及授权项说明 DRS授权分类
约束限制 您能创建的数据复制任务的数量与配额有关系，具体请参见服务配额。 目前V3 API接口仅支持MySQL->MySQL迁移和同步，MongoDB->DDS迁移，MySQL->Kafka同步，GaussDB(for MySQL)->Kafka同步，GaussDB->Gauss
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 注册并登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面的项目列表中查看账号ID。 图1 获取账号ID
获取任务ID 在调用接口的时候，部分URL中需要填入任务ID，所以需要获取到任务ID。任务ID获取方法如下： 从控制台获取任务ID 登录数据复制服务管理控制台。 在任务管理界面，查看任务ID。 或单击任务名称，在“基本信息”页签，查看当前任务的ID。 图1 基本信息 通过API获取任务ID
引擎类型说明 DRS各引擎类型对应取值可参考引擎类型说明。 表1 引擎类型说明 引擎类型（engine_type） 说明 对应源数据库取值（db_type） 对应目标数据库取值（db_type） mysql MySQL到MySQL迁移、MySQL到MySQL同步场景使用。 mysql
项目ID。 调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{endpoint}/v3/projects/”，其中{endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
选择RDS实例，单击实例后的“更多 > 登录”。 在弹出的对话框中输入密码后，单击“测试连接”检查。 连接成功后单击“登录”，登录RDS实例。 单击“新建数据库”，创建db_test测试库。 在db_test库中执行如下语句，创建对应的测试表table3_。 CREATE TABLE `db_test`
异常响应要素说明 表1 异常响应要素说明 名称 参数类型 说明 error_code String 接口响应异常时返回的错误编码，详细错误码描述参考错误码。 error_msg String 接口响应异常时返回的错误描述信息。 响应样例 { "error_code": "DRS
VARCHAR(18) 支持 执行如下步骤在源库构造数据： 根据本地的Oracle数据库的IP地址，通过数据库连接工具连接数据库。 根据支持的数据类型，在源库执行语句构造数据。 创建一个测试用的用户。 create user test_info identified by xxx; test
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 区域指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过
单击“开始创建”。 配置源库及目标库信息。 填写源库的IP、端口、用户、密码等信息。 填写完成后，需要单击“测试连接”，测试连接信息是否正确。 填写目标库的账户和密码。 填写完成后，需要单击“测试连接”，测试连接信息是否正确。 单击“下一步”，仔细阅读提示内容后，单击“同意，并继续”。 设置同步。
终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。 数据复制服务API当前支持的Region如表1和表2所示，请您根据业务需要选择对应区域的终端节点。 表1 数据复制服务v5 API当前支持的Region 区域名称
区，以提高实例的高可用性。 性能规格 通用增强Ⅱ型 8 vCPUs | 64GB 本示例中为测试实例，选择较小的测试规格，实际选择规格以业务诉求为准。 存储空间 480G 本示例中为测试实例，选择较小的存储空间，实际选择存储空间大小以业务诉求为准。 加密磁盘 不加密 本示例中选择
场景一：批量查询任务状态 场景描述 本章节指导用户通过调用批量查询任务状态，查询租户下所有任务状态。 操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。 URI格式： /v3/{project_id}/jobs/batch-status
场景三：批量启动任务 场景描述 本章节指导用户通过调用批量启动任务接口，启动多个配置完成的任务。 操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。 URI格式： /v3/{project_id}/jobs/batch-starting
区，以提高实例的高可用性。 性能规格 通用增强Ⅱ型 8 vCPUs | 64GB 本示例中为测试实例，选择较小的测试规格，实际选择规格以业务诉求为准。 存储空间 480G 本示例中为测试实例，选择较小的存储空间，实际选择存储空间大小以业务诉求为准。 加密磁盘 不加密 本示例中选择
通用请求Http Status Code 正常 表1 正常返回说明 返回值 说明 200 请求成功。 202 异步请求成功提交（任务执行等）。 异常 表2 异常返回说明 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。
场景二：批量查询任务详情 场景描述 本章节指导用户通过调用批量查询任务详情，查询租户下所有任务详情。 操作步骤 参考认证鉴权，通过调用IAM服务的API，获取用户的Token。 参考获取任务ID，获取需要查询的任务ID。 URI格式： /v3/{project_id}/jobs/batch-detail
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
