华为云用户手册

URI GET /v3/repositories/{repository_id}/commit-lines 表1 路径参数 参数 是否必选 参数类型 描述 repository_id 是 Integer 仓库短id 表2 Query参数 参数 是否必选 参数类型 描述 ref_name 是 String 分支名称 begin_date 是 String 起始提交日期,格式为yyyy-MM-dd end_date 是 String 终止提交日期,格式为yyyy-MM-dd（begin_date和end_date时间间隔不超过60天）

响应示例 状态码： 200 OK { "result" : [ { "size" : 9, "encoding" : "base64", "ref" : "master", "content" : "NDU0NTQ1NDQ1", "file_name" : "README.md", "file_path" : "README.md", "content_sha256" : "e16f4f6c41a79d120484774a625bea8a3c3dcb655aa7c7e793ac48639dc63944", "blob_id" : "3325fa3142fd66fedc8c3a5218b417f561e0ea2f", "commit_id" : "a772945ec2765e322cc83e0f467f394effa22cf3", "last_commit_id" : "a772945ec2765e322cc83e0f467f394effa22cf3" } ], "status" : "success"}

URI GET /v2/projects/{repo_id}/repository/files/{file_path} 表1 路径参数 参数 是否必选 参数类型 描述 repo_id 是 Integer 仓库短id file_path 是 String Url编码的新文件的完整路径。 表2 Query参数 参数 是否必选 参数类型 描述 ref 是 String commit id，仓库的branch名或tag名

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 error Error object 响应错误 result Array of FileContentInfo objects 差异列表 status String 响应状态 表5 Error 参数 参数类型 描述 code String 错误码 message String 错误信息 表6 FileContentInfo 参数 参数类型 描述 file_name String 文件名 file_path String 文件路径 size Integer 文件大小 encoding String 文件编码 content_sha256 String sha256编码的文件内容 ref String 分支名 blob_id String blob sha commit_id String 提交对应的SHA id last_commit_id String 最后一个提交对应的SHA id content String base64编码的文件内容

查询用户的所有仓库 接口信息： URI：GET v2/projects/repositories API Explorer 在线调试请参见：查询用户的所有仓库。 请求示例： GET https://codehub-ext.cn-north-7.myhuaweicloud.com/v2/projects/repositories 响应示例： { "result": { "total": 40, "repositories": [ { "star": false, "status": 5, "userRole": null, "repository_uuid": "25c88b23d4dc400fa7b3e2a152e4d53c", "repository_id": 522140, "repository_name": "1111111111111", "ssh_url": "git@codehub.devcloud.cn-north-208.ulanqab.huawei.com:testzxq00001/1111111111111.git", "https_url": "https://codehub.devcloud.cn-north-208.ulanqab.huawei.com/testzxq00001/1111111111111.git", "group_name": "testzxq00001", "web_url": "https://devcloud.cn-north-208.ulanqab.huawei.com/codehub/522140/home", "visibility_level": 0, "created_at": "2020-07-22 10:45:56", "updated_at": "2020-07-22 10:45:56", "repository_size": "0.16M", "lfs_size": "0.00M", "creator_name": "devcloud_codehub_l00314597_01", "domain_name": "devcloud_codehub_l00314597_01", "is_owner": 1, "iam_user_uuid": "a618e34bd5704be3ae3395dfede06041", "project_uuid": "a689e057c2304abfa35d4ff65630a90a", "project_is_deleted": "false" } ] }, "status": "success"}

步骤2：查询仓库详情 接口信息： URI：GET v2/repositories/{project_uuid} API Explorer在线调试请参见： 查询某个仓库的详细信息。 请求示例： GET https://codehub-ext.cn-north-7.myhuaweicloud.com/v2/repositories/73de3f67b30a46a4a7305f3be980c3b1 响应示例： { "result": { "star": null, "status": null, "userRole": null, "repository_uuid": "25c88b23d4dc400fa7b3e2a152e4d53c", "repository_id": 522140, "repository_name": "1111111111111", "ssh_url": "git@codehub.devcloud.cn-north-208.ulanqab.huawei.com:testzxq00001/1111111111111.git", "https_url": "https://codehub.devcloud.cn-north-208.ulanqab.huawei.com/testzxq00001/1111111111111.git", "group_name": "testzxq00001", "web_url": "https://devcloud.cn-north-208.ulanqab.huawei.com/codehub/522140/home", "visibility_level": 0, "created_at": "2020-07-22 10:45:56", "updated_at": null, "repository_size": null, "lfs_size": null, "creator_name": null, "domain_name": null, "is_owner": null, "iam_user_uuid": null, "project_uuid": "a689e057c2304abfa35d4ff65630a90a", "project_is_deleted": "false" }, "status": "success"}

步骤1：查询用户的所有仓库 接口信息： URI：GET v2/projects/repositories API Explorer在线调试请参见： 查询用户的所有仓库。 请求示例： GET https://codehub-ext.cn-north-7.myhuaweicloud.com/v2/projects/repositories 响应示例： { "result": { "total": 40, "repositories": [ { "star": false, "status": 5, "userRole": null, "repository_uuid": "25c88b23d4dc400fa7b3e2a152e4d53c", "repository_id": 522140, "repository_name": "1111111111111", "ssh_url": "git@codehub.devcloud.cn-north-208.ulanqab.huawei.com:testzxq00001/1111111111111.git", "https_url": "https://codehub.devcloud.cn-north-208.ulanqab.huawei.com/testzxq00001/1111111111111.git", "group_name": "testzxq00001", "web_url": "https://devcloud.cn-north-208.ulanqab.huawei.com/codehub/522140/home", "visibility_level": 0, "created_at": "2020-07-22 10:45:56", "updated_at": "2020-07-22 10:45:56", "repository_size": "0.16M", "lfs_size": "0.00M", "creator_name": "devcloud_codehub_l00314597_01", "domain_name": "devcloud_codehub_l00314597_01", "is_owner": 1, "iam_user_uuid": "a618e34bd5704be3ae3395dfede06041", "project_uuid": "a689e057c2304abfa35d4ff65630a90a", "project_is_deleted": "false" } ] }, "status": "success"}

调用API获取项目ID 项目ID还用通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为 IAM 的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "cn-north-4", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

步骤2：查询分支列表 接口信息： URI：GET v1/repositories/{repository_id}/branches API Explorer在线调试请参见： 查询某仓库对应的分支。 请求示例： GET https://codehub-ext.cn-north-7.myhuaweicloud.com/v1/repositories/522140/branches 响应示例： { "result": { "total": 1, "branches": [ { "name": "master", "is_protected": false } ] }, "status": "success"}

步骤1：查询用户的所有仓库 接口信息： URI：GET v2/projects/repositories API Explorer在线调试请参见：查询用户的所有仓库。 请求示例： GET https://codehub-ext.cn-north-7.myhuaweicloud.com/v2/projects/repositories 响应示例： { "result": { "total": 40, "repositories": [ { "star": false, "status": 5, "userRole": null, "repository_uuid": "25c88b23d4dc400fa7b3e2a152e4d53c", "repository_id": 522140, "repository_name": "1111111111111", "ssh_url": "git@codehub.devcloud.cn-north-208.ulanqab.huawei.com:testzxq00001/1111111111111.git", "https_url": "https://codehub.devcloud.cn-north-208.ulanqab.huawei.com/testzxq00001/1111111111111.git", "group_name": "testzxq00001", "web_url": "https://devcloud.cn-north-208.ulanqab.huawei.com/codehub/522140/home", "visibility_level": 0, "created_at": "2020-07-22 10:45:56", "updated_at": "2020-07-22 10:45:56", "repository_size": "0.16M", "lfs_size": "0.00M", "creator_name": "devcloud_codehub_l00314597_01", "domain_name": "devcloud_codehub_l00314597_01", "is_owner": 1, "iam_user_uuid": "a618e34bd5704be3ae3395dfede06041", "project_uuid": "a689e057c2304abfa35d4ff65630a90a", "project_is_deleted": "false" } ] }, "status": "success"}

SDK列表 表1提供了FunctionGraph服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 .NET huaweicloud-sdk-net-v3 .Net SDK使用指导 Node.js huaweicloud-sdk-nodejs-v3 Node.js SDK使用指导

API接口与SDK的对应关系 介绍FunctionGraph服务提供的API接口与SDK的对应方式，请参考表2。 表2 API接口与SDK的对应关系 API接口名称 对应SDK中的方法名称（不区分编程语言） 同步执行函数 invoke_function 异步执行函数 async_invoke_function 获取依赖包列表 list_dependencies 创建依赖包 create_dependency 删除依赖包 delete_dependency 获取指定依赖包 show_dependency 更新指定依赖包 update_dependency 获取测试事件列表 list_events 创建测试事件 create_event 删除测试事件 delete_event 获取测试事件详细信息 show_event 更新测试事件 update_event 查询租户配额 list_quotas 获取指定时间段的函数运行指标 list_function_statistics 租户函数统计信息 list_statistics 更新触发器 update_trigger 获取函数列表 list_functions 创建函数 create_function 删除函数/版本 delete_function 获取指定函数的所有版本别名列表 list_version_aliases 创建函数版本别名 create_version_alias 删除函数版本别名 delete_version_alias 获取函数版本的指定别名信息 show_version_alias 修改函数版本别名信息 update_version_alias 获取指定函数代码 show_function_code 修改函数代码 update_function_code 获取函数的metadata show_function_config 修改函数metadata信息 update_function_config 获取函数的版本列表 list_function_versions 发布函数版本 create_function_version 设置函数预留实例数量 update_function_reserved_instances 设置指定函数某一版本的异步配置信息 update_function_async_invoke_config 获取指定函数某一版本的异步配置信息 show_function_async_invoke_config 删除指定函数某一版本的异步配置信息 delete_function_async_invoke_config 获取指定函数所有版本的异步配置列表 list_function_async_invoke_config 删除指定函数的所有触发器 batch_delete_function_triggers 获取指定函数的所有版本别名列表 list_version_aliases 创建触发器 create_function_trigger 删除触发器 delete_function_trigger 获取指定触发器的信息 show_function_trigger

虚拟私有云 虚拟私有云（Virtual Private Cloud，简称VPC）是用户在云服务平台上申请的隔离的、私密的虚拟网络环境。用户可以自由配置VPC内的IP地址段、子网、安全组等子服务，也可以申请弹性带宽和弹性IP搭建业务系统。 ROMA Connect运行于VPC内，由虚拟私有云协助管理IP和带宽。用户在创建ROMA Connect实例时，需要关联VPC、子网和安全组。如果要为实例开启公网访问，还需要为实例绑定弹性IP地址。

分布式消息服务 Kafka 分布式消息服务 Kafka（Distributed Message Service for Kafka，简称Kafka）是一款基于开源社区版Kafka提供的消息队列服务，是一个拥有高吞吐、可持久化、可水平扩展，支持流式数据处理等多种特性的分布式消息流处理中间件。 ROMA Connect可以使用Kafka作为数据集成任务的源端和目标端，也可以使用Kafka作为LINK转发规则的目的端，把设备上报的数据转发到Kafka。

副本 为了提高消息的可靠性，Kafka的每个分区会有多个副本，对消息进行冗余备份。分区在每个副本存储一份全量数据，副本之间的消息数据保持同步。分区挑选一个副本作为Leader，该分区所有消息的生产与消费都在Leader上完成，消息从Leader副本复制到其他副本（Follower）。 Kafka的主题是一个逻辑概念，分区与副本属于物理概念。下图通过消息的生产与消费流向，解释了Kafka的分区、副本与主题间的关系。 图1 Kafka消息流

集团应用与数据集成 集团企业完成子公司与集团总部之间、集团与外部合作伙伴之间的集成面临这些瓶颈： 地域差异 集团总部和集团子公司、合作伙伴所处的地域不同，时区不同，降低了数据的时效性和可靠性。 云服务差异 集团总部和集团子公司、合作伙伴使用的云服务不一样，调用不同的云服务存在困难。 网络差异 集团总部和集团子公司、合作伙伴使用的网络不一样，公网、专网、VPN之间的对接难度很高。 ROMA Connect助力集团企业完成子公司与集团总部之间、集团与外部合作伙伴之间集成，如图1所示，ROMA Connect提供的场景方案包括： 跨域集成：集团总部、集团子公司、合作伙伴分布在不同的地域，将各自的设备信息、数据、消息传输到ROMA Connect， 由ROMA Connect执行设备信息可视化、监控告警、数据转换、消息传输等操作，打通地域限制，实现区域业务集成自治，集团信息共享，保障业务集成可靠性。 跨云集成：服务集成APIC将SaaS应用和其他第三方云应用转换成API接口，企业通过调用这些API接口，整合不同的云应用，确保云上的业务间无缝对接。 跨网集成：基于ROMA Connect实现与合作伙伴业务系统跨网安全对接。企业将合作伙伴所需数据和信息上传到ROMA Connect，根据合作伙伴的要求转换数据格式，集成数据。企业完成数据和消息的集成之后，合作伙伴可以访问ROMA Connect获取相关信息。 图1 集团应用与数据集成 通过ROMA Connect完成集团应用与数据集成会给企业带来这些优势： 构建统一管理多个云服务和云应用的平台，简化管理流程，帮助企业实现数字化转型。 实现集团总部、集团分公司、合作伙伴之间的信息共享。 支撑大规模集成业务，分布式部署，可自动扩展，低延时，保障业务性能与高可靠性。 父主题： 应用场景

工业互联网 集成 制造业数字化转型中有几类典型问题： 难以集成设备数据与环境数据 多品牌、多种类的生产设备要实现实时监控管理，则设备数据与环境数据需要采集和上传，不同品牌和种类的设备，使用的数据格式、数据库标准不一。 难以预防设备故障 工厂流水线上，任何一台机器出现故障，会对整条流水线产生巨大的影响。 难以优化企业的生产策略和决策 因为收集到的数据格式不一，给数据分析带来了难度，所以企业难以根据数据对已有的生产策略进行优化，也很难决定是否启用新的生产策略。 ROMA Connect的数据采集、集成以及借助企业级大数据分析解决方案，助力制造业向物联网集成转型，最终达成“智”造愿景。 设备数字化与统一集成 ROMA Connect使用MQTT、网关等多种方式协议连接各种类型设备与企业后台，实现企业后台与设备双向通讯。 故障预测与告警 在控制台上集成所有设备的信息，进行实时监控和预警分析，一旦设备的参数出现异常，ROMA Connect会在控制台上生成告警信息，提醒负责人对相应的设备进行维修；设备实时状态数据偏离正常运行的数据区间，可及时提醒设备保养检修。 数据转换与分析 ROMA FDI服务将工业SaaS产生的数据导入至ROMA Connect，收集并传输到 MapReduce服务 ，帮助企业进行大数据分析，优化生产策略。 图1 工业互联网集成 父主题： 应用场景

智慧园区集成 园区的智能化管理存在诸多难题： 个性化定制的管理系统阻碍信息采集和信息共享。 例如园区内建筑之间的结构存在差异，企业通过对管理各建筑的子系统进行个性化定制，可以收集到每个建筑中的所有信息。但是个性化定制之后，子系统之间的差异会对信息采集与共享造成阻碍，不能有效的传输信息，降低园区智能化的水平。 设备多样化，数据采集复杂，难以实现系统联动。 例如车辆出入管理、访客登记、园区资产管理等，由于数据采集和集中的复杂性，难以进行联动管理。 重要设备状态不能远程实时监控，无法做到预警。 例如路灯故障，传统园区需要人工保障，被动式维修。 ROMA Connect拥有设备、数据、以及服务等全套集成解决方案，助力企业打造智慧园区： 高效对接多设备、多厂商 摄像头、闸机、空调等不同厂商设备的信息，使用MQTT标准化协议接入LINK组件，同时LINK对接多个IoT平台，省去各平台分别收集数据的冗余工作。 打造数据底座，提供标准数据服务 将所有的数据，使用ROMA FDI与MQS组件进行快速集成，并开放给企业不同后端的服务。比如闸机设备系统的车辆数据，资产管理系统的设备状态、路灯系统的开关与设备信息等等，数据以实时或者异步批量的方式传输给后端服务，用作分析与联动管理。 同时，ROMA Connect的高度可扩展性设计，支撑园区海量的数据传输与存储，提升数据传输效率。 融合IT、OT、AI，构建智能运营中心 由于ROMA Connect打通了数据集成与共享的通道，企业可以借助企业级人工智能、视频分析、大数据云服务等解决方案，打造真正的智慧园区大脑。 集中+分布式的架构支撑园区业务 大型园区管理企业往往涉及众多园区，ROMA Connect的集中+分布式架构帮助企业将众多园区之间的数据集成到同一平台，协助企业根据实际情况进行分布式与集中式相结合的运营管理方式。 图1 智慧园区集成 父主题： 应用场景

配额限制 配额是指用户在ROMA Connect实例中可创建的资源数量限制，具体的资源配额限制如下表所示。 在高并发情况下会出现略超最大配额数限制的情况，不影响资源的正常使用。 表1 实例资源配额限制 组件 资源 最大配额（个） 是否支持修改配额 集成应用 集成应用 100 暂不支持 数据源 数据源 500 暂不支持 数据集成 FDI 数据集成任务数 1000 暂不支持 服务集成 APIC API 入门版：100 基础版：250 专业版：800 企业版：2000 铂金版：8000 支持 API分组 1500 支持 单个API分组内的API 入门版：100 基础版：250 专业版：800 企业版：2000 铂金版：5000 支持 单个API分组内的环境变量 50 支持 流量控制策略 300 支持 访问控制策略 100 支持 环境 10 支持 签名密钥 200 支持 负载通道 200 支持 单个负载通道内的弹性云服务器 10 支持 自定义认证 50 支持 自定义后端 入门版：50 基础版：125 专业版：400 企业版：1000 铂金版：4000 支持 客户端配额策略 20000 支持 设备集成LINK 产品模板 100 支持 产品 500 支持 设备 1000 支持 规则 2000 不支持

概述 欢迎使用 数据复制服务 （Data Replication Service，简称DRS）。数据复制服务是一种易用、稳定、高效、用于数据库在线迁移和数据库实时同步的云服务。数据复制服务是通过创建任务，以任务作为数据库迁移的导向。 您可以使用本文档提供的API对数据复制任务进行相关操作，如创建、获取详情、获取列表、删除等。支持的全部操作请参见API概览。 在调用数据复制服务API之前，请确保已经充分了解数据复制服务的相关概念，详细信息请参见产品介绍。 父主题： 使用前必读

DRS授权分类 “√”表示支持，“x”表示暂不支持。 表1 任务功能 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 批量创建任务 POST /v3/{project_id}/jobs/batch-creation drs:migrationJobs:create（创建实例需要在项目上配置 RDS ReadOnlyAccess、VPC FullAccess、 SMN FullAccess权限。） √ √ 批量结束和删除任务 DELETE /v3/{project_id}/jobs/batch-jobs drs:migrationJobs:delete（结束和删除实例需要在项目上配置 RDS ReadOnlyAccess、VPC FullAccess、SMN FullAccess权限。） √ √ 批量测试连接 POST /v3/{project_id}/jobs/batch-connection drs:migrationJobs:connect（测试连接需要在项目上配置 VPC FullAccess权限。） √ √ 批量数据库对象选择信息 PUT /v3/{project_id}/jobs/batch-select-objects drs:migrationJobs:select（对象选择信息需要在项目上配置 RDS FullAccess、DAS FullAccess) √ √ 批量查询rpo和rto POST /v3/{project_id}/jobs/batch-rpo-and-rto drs:dataGuardJob:list √ √ 批量主备倒换 POST /v3/{project_id}/jobs/batch-switchover drs:disasterRecoveryJob:switchover √ √ 批量测试连接-集群模式 POST /v3/{project_id}/jobs/cluster/batch-connection drs:migrationJobs:connect（测试连接需要在项目上配置 VPC FullAccess权限。） √ √ 批量预检查 POST /v3/{project_id}/jobs/batch-precheck drs:migrationJob:action √ √ 批量查询预检查结果 POST /v3/{project_id}/jobs/batch-precheck-result drs:migrationJob:get √ √ 批量设置任务限速 PUT /v3/{project_id}/jobs/batch-limit-speed drs:migrationJobs:update √ √ 批量获取数据库参数 POST /v3/{project_id}/jobs/batch-get-params drs:databaseParameters:get √ √ 批量续传/重试 POST /v3/{project_id}/jobs/batch-retry-task drs:migrationJob:action √ √ 批量暂停任务 POST /v3/{project_id}/jobs/batch-starting drs:migrationJob:action √ √ 批量修改任务 PUT /v3/{project_id}/jobs/batch-modification drs:migrationJob:modify √ √ 批量修改源库/目标库密码 PUT /v3/{project_id}/jobs/batch-modify-pwd drs:migrationJobs:update √ √ 批量设置definer POST /v3/{project_id}/jobs/batch-replace-definer drs:migrationJob:updateJobConfig √ √ 批量创建对比任务 POST /v3/{project_id}/jobs/batch-create-compar drs:migrationCompareJob:create √ √ 批量查询对比结果 POST /v3/{project_id}/jobs/batch-compare-result drs:CompareJob:getResult √ √ 批量查询任务进度 POST /v3/{project_id}/jobs/batch-progress drs:migrationJobs:getProgress √ √ 查询租户任务列表 POST /v3/{project_id}/jobs DRS ReadOnlyAccess √ √ 查询容灾监控数据 POST /v3/{project_id}/jobs/disaster-recovery-monitoring-data drs:disasterRecoveryJob:get √ √ 批量查询灾备初始化进度 POST /v3/{project_id}/jobs/batch-struct-process drs:disasterRecoveryJob:get √ √ 批量查询灾备初始化对象详情 POST /v3/{project_id}/jobs/{type}/batch-struct-detail drs:disasterRecoveryJob:get √ √ 批量更新迁移用户信息 PUT /v3/{project_id}/jobs/batch-update-user drs:migrationJob:modifyUserInfo √ √ 修改数据库参数 POST /v1.0/{projectId}/jobs/{jobId}/params drs:dataBaseParams:modify（配置 RDS ReadOnlyAccess、VPC FullAccess、SMN FullAccess，DAS FullAccess权限。） √ √ 批量数据加工 POST /v3/{project_id}/jobs/batch-transformation drs:migrationJob:action √ √ 批量启动任务 POST /v3/{project_id}/jobs/batch-starting drs:migrationJob:action √ √ 批量查询任务详情 POST /v3/{project_id}/jobs/batch-detail drs:migrationJob:get √ √ 批量查询任务状态 POST /v3/{project_id}/jobs/batch-status drs:migrationJob:get √ √ 父主题： 权限策略和授权项

通过API获取任务ID 任务ID还可通过调用批量创建任务API创建任务后获取。 创建任务成功后，响应示例如下，其中的“id”即为任务ID。 { "results" : [ { "id" : "e11eaf8f-71ef-4fad-8890-aed7572ajb11", "name" : "DRS-9228", "status" : "CREATING", "create_time" : "1599188556112" } ], "count" : 1}

终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。 数据复制服务API当前支持的Region如表1和表2所示，请您根据业务需要选择对应区域的终端节点。 表1 数据复制服务v5 API当前支持的Region 区 域名 称 区域 终端节点（Endpoint） 协议类型 华南-深圳 cn-south-2 drs.cn-south-2.myhuaweicloud.com HTTPS 华南-广州-友好用户环境 cn-south-4 drs.cn-south-4.myhuaweicloud.com HTTPS 表2 数据复制服务v3 API当前支持的Region 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京一 cn-north-1 drs.cn-north-1.myhuaweicloud.com HTTPS 华北-北京二 cn-north-2 drs.cn-north-2.myhuaweicloud.com HTTPS 华北-北京四 cn-north-4 drs.cn-north-4.myhuaweicloud.com HTTPS 华北-乌兰察布一 cn-north-9 drs.cn-north-9.myhuaweicloud.com HTTPS 华东-上海一 cn-east-3 drs.cn-east-3.myhuaweicloud.com HTTPS 华东-上海二 cn-east-2 drs.cn-east-2.myhuaweicloud.com HTTPS 华南-广州 cn-south-1 drs.cn-south-1.myhuaweicloud.com HTTPS 华南-深圳 cn-south-2 drs.cn-south-2.myhuaweicloud.com HTTPS 西南-贵阳一 cn-southwest-2 drs.cn-southwest-2.myhuaweicloud.com HTTPS 拉美-圣地亚哥 la-south-2 drs.la-south-2.myhuaweicloud.com HTTPS 拉美-圣保罗一 sa-brazil-1 drs.sa-brazil-1.myhuaweicloud.com HTTPS 非洲-约翰内斯堡 af-south-1 drs.af-south-1.myhuaweicloud.com HTTPS 中国-香港 ap-southeast-1 drs.ap-southeast-1.myhuaweicloud.com HTTPS 亚太-新加坡 ap-southeast-3 drs.ap-southeast-3.myhuaweicloud.com HTTPS 亚太-曼谷 ap-southeast-2 drs.ap-southeast-2.myhuaweicloud.com HTTPS 亚太-雅加达 ap-southeast-4 drs.ap-southeast-4.myhuaweicloud.com HTTPS 土耳其-伊斯坦布尔 tr-west-1 drs.tr-west-1.myhuaweicloud.com HTTPS 父主题： 使用前必读

响应参数 状态码： 200 表8 响应Body参数 参数 参数类型 描述 results Array of objects 批量数据加工响应列表。 详情请参见表9。 count integer 总数。 表9 results字段数据结构说明 参数 参数类型 描述 id String 任务ID。 status String 状态。取值： success failed error_code String 错误码。 error_msg String 错误信息。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 指定类型为application/json。 缺省值：application/json X-Auth-Token 是 String 从IAM服务获取的用户Token。 X-Language 否 String 请求语言类型。 缺省值：en-us 取值： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 jobs 是 Array of objects 批量数据加工规则请求列表。 详情请参见表4。 表4 jobs字段数据结构说明 参数 是否必选 参数类型 描述 job_id 否 String 任务ID。 object_info 否 Array of objects 对象信息，生成加工规则时需要填写。 详情请参见表5。 transformation_info 是 Object 加工信息。 详情请参见表6 config_transformation 否 Object 配置信息，如果存在多张关联表，请生成多条配置规则。满足配置条件的数据将暂存到缓存中，在数据过滤的场景进行使用。 配置的库名和表名支持数字、字母和下划线。 配置的列名、主键、索引，请确保与源库配置表的字段名保持大小写一致。 详情请参见表7。 表5 object_info字段数据结构说明 参数 是否必选 参数类型 描述 id 否 String 数据库名称和数据库表名称，例如格式为lxl_test1-*-*-test_1，其中lxl_test1为数据库名称，test_1为表名称。 select 否 String 是否选择高级配置，值为true。 表6 transformation_info字段数据结构说明 参数 是否必选 参数类型 描述 transformation_type 是 String 生成加工规则值为contentConditionalFilter。 生成配置规则值为configConditionalFilter。 取值： contentConditionalFilter configConditionalFilter value 是 String 过滤条件，生成加工规则值为sql条件语句，生成配置规则值为config。长度限制256。 表7 config_transformation字段数据结构说明 参数 是否必选 参数类型 描述 db_table_name 是 String 库名.表名，例如格式为lxl_test1.test_1，其中lxl_test1为库名，test_1为表名。 db_name 是 String 库名。长度限制256。 table_name 是 String 表名。长度限制256。 col_names 是 String 列名。长度限制256。 prim_key_or_index 是 String 主键或唯一索引。长度限制256。 indexs 是 String 优化查询所需的索引。长度限制256。 values 是 String 过滤条件。长度限制256。

状态码 状态码如表1所示： 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 200 OK 请求成功。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 NoContent 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确，但是由于含有语义错误，无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本，无法完成处理。 父主题： 附录

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token的接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "cn-north-1", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

请求示例 批量查询任务状态示例： https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-status{ "jobs" : [ "9a470239-2308-4bb5-a6bc-1040402fjb21", "dc67695a-ee3e-49b8-a022-a099bd81jb21" ], "page_req" : { "cur_page" : 1, "per_page" : 10 }}

响应示例 状态码： 200 OK { "results" : [ { "id" : "9a470239-2308-4bb5-a6bc-1040402fjb21", "status" : "INCRE_TRANSFER_STARTED" }, { "id" : "dc67695a-ee3e-49b8-a022-a099bd81jb21", "status" : "INCRE_TRANSFER_FAILED" } ], "count" : 2}

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 results Array of objects 任务状态信息。 详情请参见表6。 count Integer 返回任务数量。 表6 results字段数据结构说明 参数 参数类型 描述 id String 任务ID。 status String 任务状态。 CREATING：创建中 CREATE_FAILED：创建失败 CONFIGURATION：配置中 STARTJOBING：启动中 WAITING_FOR_START：等待启动中 START_JOB_FAILED：启动失败 PAUSING：已暂停 FULL_TRANSFER_STARTED：全量开始，灾备场景下为初始化 FULL_TRANSFER_FAILED：全量失败，灾备场景下为初始化失败 FULL_TRANSFER_COMPLETE：全量完成，灾备场景下为初始化完成 INCRE_TRANSFER_STARTED：增量开始，灾备场景下为灾备中 INCRE_TRANSFER_FAILED：增量失败，灾备场景下为灾备异常 RELEASE_RESOURCE_STARTED：结束任务中 RELEASE_RESOURCE_FAILED：结束任务失败 RELEASE_RESOURCE_COMPLETE：已结束 REBUILD_NODE_STARTED：故障恢复中 REBUILD_NODE_FAILED：故障恢复失败 CHANGE_JOB_STARTED：任务变更中 CHANGE_JOB_FAILED：任务变更失败 DELETED：已删除 CHILD_TRANSFER_STARTING：再编辑子任务启动中 CHILD_TRANSFER_STARTED：再编辑子任务迁移中 CHILD_TRANSFER_COMPLETE：再编辑子任务迁移完成 CHILD_TRANSFER_FAILED：再编辑子任务迁移失败 RELEASE_CHILD_TRANSFER_STARTED：再编辑子任务结束中 RELEASE_CHILD_TRANSFER_COMPLETE：再编辑子任务已结束 NODE_UPGRADE_START：升级开始 NODE_UPGRADE_COMPLETE：升级完成 NODE_UPGRADE_FAILED：升级失败 枚举值： CREATING CREATE_FAILED CONFIGURATION STARTJOBING WAITING_FOR_START START_JOB_FAILED PAUSING FULL_TRANSFER_STARTED FULL_TRANSFER_FAILED FULL_TRANSFER_COMPLETE INCRE_TRANSFER_STARTED INCRE_TRANSFER_FAILED RELEASE_RESOURCE_STARTED RELEASE_RESOURCE_FAILED RELEASE_RESOURCE_COMPLETE REBUILD_NODE_STARTED REBUILD_NODE_FAILED CHANGE_JOB_STARTED CHANGE_JOB_FAILED DELETED CHILD_TRANSFER_STARTING CHILD_TRANSFER_STARTED CHILD_TRANSFER_COMPLETE CHILD_TRANSFER_FAILED RELEASE_CHILD_TRANSFER_STARTED RELEASE_CHILD_TRANSFER_COMPLETE NODE_UPGRADE_START NODE_UPGRADE_COMPLETE NODE_UPGRADE_FAILED error_code String 错误码。 error_message String 错误信息。