检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
json,如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。 缺省值:application/json X-Auth-Token 是 String 从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。
项目ID。 调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{endpoint}/v3/projects/”,其中{endpoint}为IAM的终端节点,可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
约束限制 您能创建的数据复制任务的数量与配额有关系,具体请参见服务配额。 目前V3 API接口仅支持MySQL->MySQL迁移和同步,MongoDB->DDS迁移,MySQL->Kafka同步,GaussDB(for MySQL)->Kafka同步,GaussDB->Gauss
使用前必读 概述 调用说明 终端节点 约束限制 基本概念
授权,用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制,可以在区域默认的项目中创建子项目,并在子项目中购买资源,然后以子项目为单位进行授权,使得用户仅能访问特定子项目中资源,使得资源的权限控制更加精确。 图1 项目隔离模型 同样在我的凭证下,您可以查看项目ID。
调用说明 数据复制服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 注册并登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“API凭证”页面的项目列表中查看账号ID。 图1 获取账号ID
权更加精细,可以精确到某个操作。 如果您要允许或是禁止某个接口的操作权限,请使用细粒度策略。 账号具备所有接口的调用权限,如果使用账号下的IAM用户发起API请求时,该IAM用户必须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权
获取任务ID 在调用接口的时候,部分URL中需要填入任务ID,所以需要获取到任务ID。任务ID获取方法如下: 从控制台获取任务ID 登录数据复制服务管理控制台。 在任务管理界面,查看任务ID。 或单击任务名称,在“基本信息”页签,查看当前任务的ID。 图1 基本信息 通过API获取任务ID
请求要求代理的身份认证,与401类似,但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码,表明客户端尝试创建的资源已经
权限策略和授权项 策略及授权项说明 DRS授权分类
终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询服务的终端节点。 数据复制服务API当前支持的Region如表1和表2所示,请您根据业务需要选择对应区域的终端节点。 表1 数据复制服务v5 API当前支持的Region 区域名称
源库实例ChangeStream接口是否可用 MongoDB->DDS迁移场景 表1 源库实例ChangeStream接口是否可用 预检查项 源库实例ChangeStream接口是否可用。 描述 检查源库实例ChangeStream接口是否可用。 不通过提示及处理建议 不通过原因
异常响应要素说明 表1 异常响应要素说明 名称 参数类型 说明 error_code String 接口响应异常时返回的错误编码,详细错误码描述参考错误码。 error_msg String 接口响应异常时返回的错误描述信息。 响应样例 { "error_code": "DRS
任务状态说明 表1 任务状态说明 状态值 状态说明 CREATING 创建中。 CREATE_FAILED 创建失败。 CONFIGURATION 配置中。 STARTJOBING 启动中。 WAITING_FOR_START 等待启动中。 START_JOB_FAILED 任务启动失败。
引擎类型说明 DRS各引擎类型对应取值可参考引擎类型说明。 表1 引擎类型说明 引擎类型(engine_type) 说明 对应源数据库取值(db_type) 对应目标数据库取值(db_type) mysql MySQL到MySQL迁移、MySQL到MySQL同步场景使用。 mysql
任务创建流程 迁移任务创建流程 图1 实时迁移任务创建流程 获取用户token:通过调用IAM服务的API,获取用户的Token。 创建迁移实例:根据需要,创建迁移任务。 查询任务创建进度:查询任务当前具体状态 测试连接:测试与源库和目标库的连接,以便继续进行任务。 更新任务信息
ACK_PERIOD_TIME = 5000 以上参数值为默认配置,您可以使用默认值,也可以根据实际情况自定义参数值。 以上涉及到时间的单位均为微秒。 确认机制 SDK采用的是自动批量确认机制,不需要客户端程序调用确认函数,可以重复确认。 例如:客户端收到了5个batch的消息,但是服务端
数据加工 数据复制服务支持对同步的对象进行加工,即可以为选择的对象添加规则。各链路支持的加工规则不一样,目前仅部分链路支持数据加工,支持数据加工链路参考表1,具体操作方法可参考对应的内容。 表1 支持数据加工的链路 同步方向 数据流向 数据过滤 附加列 列加工 入云 MySQL->MySQL
场景三:批量启动任务 场景描述 本章节指导用户通过调用批量启动任务接口,启动多个配置完成的任务。 操作步骤 参考认证鉴权,通过调用IAM服务的API,获取用户的Token。 参考获取任务ID,获取需要查询的任务ID。 URI格式: /v3/{project_id}/jobs/batch-starting