华为云用户手册

免费体验 GaussDB(DWS) 数据分析实验室是华为云官方实验平台，实验环境为华为云现网环境，整个实验过程完全免费。供您在最短时间内体验 GaussDB (DWS)真实环境，快速上手。 开发者可通过表1实验手册指导，使用环境中预置的华为云账号，一键创建GaussDB(DWS)实验环境，在云端体验GaussDB(DWS)的数据导入、访问 MRS 集群、多维度分析、权限管理、JDBC开发、性能调优等场景。 表1 实验列表 场景 实验名称 实验描述 预计时长 导入分析 快速入门 一键式创建GaussDB(DWS)集群，上传csv本地数据到 云存储 OBS桶，通过创建OBS外表实现数据导入并简单分析。 1h 零售业经营多维度分析 环境已预置样例数据在OBS桶，通过创建OBS外表导入样例数据，再使用聚合函数、group by、order by、视图进行多维度分析。 1.5h SQL on Hadoop 导入MRS-Hive数据源 创建 数据仓库 集群GaussDB(DWS)，并导入MRS的Hive数据，实现跨集群进行大数据融合分析。 1.5h 二次开发 使用Java进行二次开发 使用JDBC驱动连接GaussDB(DWS)进行二次开发，熟悉简单的适配DWS的Java开发用例。 1.5h 数据迁移 从老DWS集群迁移数据到新DWS集群 本实验指导用户创建数据仓库集群GaussDB(DWS)并将老GaussDB(DWS)整库迁移到新的GaussDB(DWS)。同时，针对使用自增序列导致的性能问题场景，指导用户排查原因并提供优化方法。 2~3h 基于gds实现跨集群数据互联互通 本实验通过部署GDS服务器，使用GDS导入导出的并发能力，实现双DWS集群之间1500万行数据分钟级迁移。 2h 安全管理 权限管理 通过实验创建不同用户，不同Schema，基于权限管理实现数据的隔离和互访，了解用户、角色的关系，了解grant的基本用法，了解基于角色的权限管理(RBAC)。 1.5h 使用数据脱敏实现卡号等隐私信息屏蔽 本实验通过创建数据仓库服务GaussDB(DWS)并使用DWS的数据脱敏功能，针对不同用户设置部分数据列的屏蔽，实现敏感数据脱敏，确保数据安全。 1h 高级特性 冷热数据管理 指导用户创建数据仓库集群GaussDB(DWS)，并创建冷热分区表实现冷热数据分区管理，不仅可以提高数据分析性能还能降低业务成本。 1h 调优 性能调优 指导用户使用GaussDB(DWS)进行性能调优。通过本实验掌握通过EXPLAIN语句查询执行计划的方法，了解GaussDB(DWS)几种常见的SQL调优手段。 2h 云原生3.0 云原生3.0数仓-存算分离 本实验指导用户创建GaussDB(DWS)新一代Serverless云原生数仓，并体验Serverless存算分离架构下的极致查询。 2h 云原生3.0数仓-湖仓一体 本实验指导用户创建GaussDB(DWS)新一代Serverless云原生数仓，通过EXTERNAL SCHEMA访问MRS的Hive数据，体验湖仓一体、存算分离等极致查询的高级特性。 2h

GaussDB(DWS)入门实践 当用户完成集群创建后，可以根据自身的业务需求使用GaussDB(DWS)提供的一系列常用实践。 表1 常用最佳实践 实践 描述 数据导入导出 从OBS导入数据到集群 本教程旨在通过演示将样例数据上传OBS，及将OBS的数据导入进GaussDB(DWS)上的目标表中，让您快速掌握如何从OBS导入数据到GaussDB(DWS)集群的完整过程。 GaussDB(DWS)支持通过外表将OBS上TXT、 CS V、ORC、PARQUET、CARBONDATA以及JSON格式的数据导入到集群进行查询。 使用GDS从远端服务器导入数据 本教程旨在演示使用GDS（General Data Service）工具将远端服务器上的数据导入GaussDB(DWS)中的办法，帮助您学习如何通过GDS进行数据导入的方法。 GaussDB(DWS)支持通过GDS外表将TXT、CSV和FIXED格式的数据导入到集群进行查询。 导入远端DWS数据源 大数据融合分析场景下，支持同一区域内的多套GaussDB(DWS)集群之间的数据互通互访，本实践将演示通过Foreign Table方式从远端DWS导入数据到本端DWS。 本实践演示过程为：以gsql作为数据库客户端，gsql安装在ECS，通过gsql连接DWS，再通过外表方式导入远端DWS的数据。 导出ORC数据到MRS GaussDB(DWS)数据库支持通过HDFS外表导出ORC格式数据至MRS，通过外表设置的导出模式、导出数据格式等信息来指定导出的数据文件，利用多DN并行的方式，将数据从GaussDB(DWS)数据库导出到外部，存放在HDFS文件系统上，从而提高整体导出性能。 数据迁移 Oracle迁移到GaussDB(DWS)实践 本教程演示将Oracle业务相关的表数据迁移到GaussDB(DWS)的数据库的基本过程。 MySQL表数据实时同步到GaussDB(DWS)实践 本实践演示通过华为云 数据复制服务 DRS完成MySQL数据实时同步到GaussDB(DWS)的基本过程。 通过 DLI Flink作业将Kafka数据实时写入DWS 本实践演示通过 数据湖探索 服务DLI Flink作业将分布式消息服务Kafka的消费数据实时同步至DWS数据仓库，实现Kafka实时入库到DWS的过程。 本实践预计时长90分钟，实践用到的云服务包括 虚拟私有云VPC 及子网、弹性负载均衡ELB、弹性 云服务器ECS 、 对象存储服务 OBS、分布式消息服务Kafka、 数据湖 探索DLI和数据仓库服务DWS 调优表 调优表实践 在本实践中，您将学习如何优化表的设计。您首先不指定存储方式，分布键、分布方式和压缩方式创建表，然后为这些表加载测试数据并测试系统性能。接下来，您将应用优秀实践以使用新的存储方式、分布键、分布方式和压缩方式重新创建这些表，并再次为这些表加载测试数据和测试系统性能，以便比较不同的设计对表的加载性能、存储空间和查询性能的影响。 估计时间：60 分钟。 高级特性 冷热数据管理优秀实践 海量大数据场景下，随着业务和数据量的不断增长，数据存储与消耗的资源也日益增长。根据业务系统中用户对不同时期数据的不同使用需求，对膨胀的数据进行“冷热”分级管理，不仅可以提高数据分析性能还能降低业务成本。针对数据使用的一些场景，可以将数据按照时间分为：热数据、冷数据。 分区自动管理优秀实践 对于分区列为时间的分区表，分区自动管理功能可以自动创建新分区和删除过期分区，降低分区表的维护成本，改善查询性能。为了便于查询和维护数据，用户通常使用分区列为时间的分区表来存储时间相关的数据，例如电商的订单信息、 物联网采集的实时数据。这些时间相关的数据导入分区表时，需要保证分区表要有对应时间的分区，由于普通的分区表不会自动创建新的分区和删除过期的分区，所以维护人员需要定期创建新分区和删除过期分区，提高了运维成本。 为解决上述问题，GaussDB(DWS) 引入了分区自动管理特性。可通过设置表级参数period、ttl开启分区自动管理功能，使分区表可以自动创建新分区和删除过期分区，降低分区表的维护成本，改善查询性能。 数据库管理 资源管理优秀实践 本实践将演示GaussDB(DWS)的资源管理功能，帮助企业客户解决数据分析过程中，多用户查询作业遇到的性能瓶颈，最终实现多用户执行SQL作业互不影响，节省资源消耗。 SQL查询优秀实践 根据数据库的SQL执行机制以及大量的实践总结发现：通过一定的规则调整SQL语句，在保证结果正确的基础上，能够提高SQL执行效率。 数据倾斜查询优秀实践 本实践包含以下存储倾斜案例： 导入过程存储倾斜即时检测 快速定位查询存储倾斜的表 用户管理优秀实践 GaussDB(DWS)集群中，常用的用户分别是系统管理员和普通用户。本实践简述了系统管理员和普通用户的权限，如何创建以及如何查询用户相关信息。 查看表和数据库的信息 本实践演示了基本数据库查询案例： 查询表信息 查询表大小 查询数据库 查询数据库大小 模拟数据分析 交通卡口通行车辆分析 本实践将演示交通卡口车辆通行分析，将加载8.9亿条交通卡口车辆通行模拟数据到数据仓库单个数据库表中，并进行车辆精确查询和车辆模糊查询，展示GaussDB(DWS) 对于历史详单数据的高性能查询能力。 供应链需求分析(TPC-H数据集) 本实践将演示从OBS加载样例数据集到GaussDB(DWS) 集群中并查询数据的流程，从而向您展示GaussDB(DWS) 在数据分析场景中的多表分析与主题分析。 零售业百货公司经营状况分析 本实践将演示以下场景：从OBS加载各个零售商场每日经营的业务数据到数据仓库对应的表中，然后对商铺营业额、客流信息、月度销售排行、月度客流转化率、月度租售比、销售坪效等KPI信息进行汇总和查询。本示例旨在展示在零售业场景中GaussDB(DWS) 数据仓库的多维度查询分析的能力。 数据安全 实现数据列的加解密 数据加密 作为有效防止未授权访问和防护数据泄露的技术，在各种信息系统中广泛使用。作为信息系统的核心，GaussDB(DWS)数仓也提供数据加密功能，包括透明加密和使用SQL函数加密。本章节主要讨论SQL函数加密。

创建、查看和删除数据库 使用CREATE DATABASE语句创建数据库。 1 CREATE DATABASE test_db ENCODING 'UTF8' template = template0; 使用\l元命令查看数据库系统的数据库列表。 1 \l 通过系统表PG_DATABASE查询数据库列表。 1 SELECT datname FROM pg_database; 使用DROP DATABASE语句删除数据库。 1 DROP DATABASE test_db;

创建、查看、修改和删除表 使用CREATE TABLE语句创建表。 1 CREATE TABLE customer_t1(id INT, name CHAR(40),age TINYINT); 使用PG_GET_TABLEDEF()函数查看建表语句。 1 SELECT * FROM PG_GET_TABLEDEF('customer_t1'); 使用ALTER TABLE语句修改表。 增加列： 1 ALTER TABLE customer_t1 ADD (address VARCHAR(100)); 删除列： 1 ALTER TABLE customer_t1 DROP COLUMN address; 修改字段类型： 1 ALTER TABLE customer_t1 MODIFY age INTEGER NOT NULL; 使用DROP TABLE语句删除表。 1 DROP TABLE customer_t1;

增删改查表数据 使用INSERT INTO语句插入表数据。 1 INSERT INTO customer_t1 VALUES(1001,'user1',22); 使用SELECT语句查询表数据。 1 SELECT * FROM customer_t1; 使用UPDATE更新表数据。 1 UPDATE customer_t1 SET id = 1009 WHERE id = '1001'; 使用DELETE删除表数据。 1 DELETE FROM customer_t1 WHERE id = '1009';

准备工作 使用专属资源池部署在线服务，服务状态为“运行中”。 需使用新版专属资源池部署服务，详情请参见ModelArts Standard资源池功能介绍。 只有专属资源池部署的服务才支持VPC直连的高速访问通道。 VPC直连的高速访问通道，目前只支持访问在线服务。 因流量限控，获取在线服务的IP和端口号次数有限制，每个主账号租户调用次数不超过2000次/分钟，每个子账号租户不超过20次/分钟。 目前仅支持 自定义镜像 导入模型，部署的服务支持高速访问通道。

准备工作 在购买网页防篡改防护之前，请先 注册华为账号 并开通华为云。具体操作详见注册华为账号并开通华为云、实名认证。 如果您已开通华为云并进行实名认证，请忽略此步骤。 请保证账户有足够的资金，以避免购买HSS防护配额失败。具体操作请参见账户充值。 若使用 IAM 用户进行操作，请确保已为IAM用户赋予“HSS FullAccess”权限。具体操作请参见创建用户并授权使用HSS。 购买HSS防护配额时，还需要为IAM用户授予“BSS Administrator”权限。 已准备好用于开启网页防篡改防护的华为云弹性云服务器。

相关操作 修改防护目录下的文件/文件夹 开启网页防篡改防护后，对应防护目录下的文件/文件夹为只读状态，不允许被修改，如果您需要修改防护目录下的文件/文件夹，请参考以下方式： 添加特权进程：特权进程最多支持添加10个，详细操作请参见添加特权进程。 定时开启/关闭静态网页防篡改：除了添加特权进程外，您可以设置定时开启/关闭静态网页防篡改，在网页防篡改关闭时段修改文件/文件夹，详细操作请参见定时开启/关闭静态网页防篡改。 开启服务器主动防护功能 企业主机安全 网页防篡改版为服务器提供了一些主动防护功能，这些功能在开启网页防篡改防护时并未开启或未完全开启，您可以根据自身的业务情况综合考虑是否使用这些功能，需要您自行选择开启的功能及说明如表 服务器主动防护功能说明。 表4 服务器主动防护功能说明 功能 说明 勒索病毒防护 勒索病毒入侵主机后，会对主机数据进行加密勒索，导致主机业务中断、数据泄露或丢失，主机所有者即使支付赎金也可能难以挽回所有损失，因此勒索病毒是当今网络安全面临的最大挑战之一。企业主机安全支持静态、动态勒索病毒防护，定期备份主机数据，可以帮助您抵御勒索病毒，降低业务损失风险。 开启网页防篡改防护会自动为您开启勒索病毒防护，在您的主机上部署诱饵文件，并对可疑加密程序执行自动隔离。您可以修改勒索病毒防护策略，同时建议您开启勒索备份以提升勒索事后恢复能力。 应用防护 应用防护功能旨在为运行时的应用提供安全防御。您无需修改应用程序文件，只需将探针注入到应用程序，即可为应用提供强大的安全防护能力。 应用进程控制 应用进程控制功能支持管控应用进程运行，通过学习服务器中运行的应用进程特征，将应用进程划分为可信进程、恶意进程和可疑进程，允许可疑、可信进程正常运行，对恶意进程运行进行告警，帮助用户构建安全的应用进程运行环境，避免服务器遭受不受信或恶意应用进程的破坏。 病毒查杀 病毒查杀功能使用特征病毒检测引擎，支持扫描服务器中的病毒文件，扫描文件类型覆盖可执行文件、压缩文件、脚本文件、文档、图片、音视频文件；用户可根据自身需要，自主对服务器执行“快速查杀”、“全盘查杀”、“自定义查杀”扫描任务，并及时处置检测到的病毒文件，增强业务系统的病毒防御能力。

专享版QPS性能参考 专享版API网关QPS（Query Per Second，每秒查询率）吞吐受应答大小、是否开启HTTPS、是否开启gzip等多种因素影响。下表是API网关处于30%CPU水位下的QPS参考值，参考场景为无认证和单机流控模式。 安全水位指能够在突发流量增长至双倍的情况下，API网关系统依然维持高吞吐量和低延迟性能。 表4 基础版、专业版、企业版的QPS性能参考 实例规格 基础版 专业版 企业版 连接类型 应答字节数（KBytes） 是否使用HTTPS 是否使用gzip CPU处于安全水位（30%）的QPS参考 短连接 1 否 否 3500 3600 9000 是 否 1000 1100 2800 长连接 1 否 否 4500 4200 13000 是 否 4000 4000 11000 10 否 否 3500 4000 10000 是 否 3200 3800 9500 表5 铂金版的QPS性能参考 实例规格 铂金版 铂金版X2 铂金版X3 铂金版X4 铂金版X5 铂金版X6 铂金版X7 铂金版X8 连接类型 应答字节数（KBytes） 是否使用HTTPS 是否使用gzip CPU处于安全水位（30%）的QPS参考 短连接 1 否 否 55000 72000 90000 100000 150000 180000 200000 200000 是 否 16000 20000 24000 35000 42000 48000 54000 60000 长连接 1 否 否 79000 105000 130000 240000 270000 320000 330000 305000 是 否 67000 95000 120000 210000 265000 300000 320000 300000 10 否 否 67000 85000 95000 180000 200000 222000 220000 210000 是 否 65000 80000 90000 170000 195000 220000 210000 205000

响应参数 状态码： 200 表3 响应Body参数 参数名称 参数类型 说明 is_success Boolean 执行请求是否成功。“true”表示请求执行成功。 message String 系统提示信息，执行成功时，信息可能为空。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述信息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述信息。

响应示例 { "count": 2, "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }

URI GET /v3/{project_id}/{resource_type}/{resource_id}/tags 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号，用于资源隔离。获取方式请参考获取项目ID。 resource_type 是 String 资源类型。 dli_queue：队列 dli_elastic_resource_pool：弹性资源池 dli_enhanced_datasource：增强型跨源连接 dli_database：数据库 dli_package_resource：资源包（不支持指定有Module ID的内置资源包） dli_flink_job：Flink作业 resource_id 是 String 资源ID。 最小长度：1 最大长度：1000 获取方式： 队列ID：通过调用查询所有队列获队列ID。响应中的queue_id为队列ID。 弹性资源池ID：通过调用查询所有弹性资源池获弹性资源池ID。响应中的resource_id为弹性资源池ID。 增强型跨源连接ID：在DLI管理控制台的“增强型跨源连接”列表页获取“连接ID”即为增强型跨源连接ID。 数据库ID：添加标签时候传入的数据库ID即数据库名。您可以在DLI控制台的“库表管理”页面查看数据库名称。 Flink作业ID：在DLI管理控制台的“Flink作业”列表页面单击Flink作业名称，在Flink作业的详情页面即可获取Flink作业ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页显示条数，默认为1000。 offset 否 Integer 查询结果偏移量，默认为0。

响应参数 状态码： 200 表3 响应Body参数 参数名称 参数类型 说明 is_success Boolean 执行请求是否成功。“true”表示请求执行成功。 message String 系统提示信息，执行成功时，信息可能为空。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述信息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述信息。

注册华为账号并开通华为云 如果您已完成华为账号注册，可以跳过该步骤。 打开华为云官方网站。 单击华为云官网右上角“注册”进入注册页面。 在注册页面，输入手机号，并获取并输入手机收到的验证码。 请使用中国大陆的手机号码。 一个手机号可以注册3个华为账号，如账号数量已达到3个，将不支持使用该手机号注册新的华为账号。 设置账号密码，并单击“注册”。 至少包含8个字符。 至少包含字母和数字，不能包含空格。 勾选服务条款，单击“开通”。

实例规格变更须知 支持实例规格变更明细如下： 表2 实例规格变更明细 缓存类型 单机实例 主备实例 Cluster集群实例 Proxy集群实例 读写分离实例 Redis 3.0 支持扩容和缩容 支持扩容和缩容 - 仅支持扩容 - Redis 4.0 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 5.0 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 6.0 基础版 支持扩容和缩容 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 6.0 企业版 - 支持扩容和缩容 - - - Memcached 支持扩容和缩容 支持扩容和缩容 - - - Redis 3.0和Memcached实例在预留内存不足的情况下，内存用满可能会导致扩容失败，具体可参考预留内存。 副本数变更和容量变更不支持同时进行，需分开两次执行变更。 删除副本时，每次操作仅支持删除一个副本。 实例规格变更的影响： 表3 实例规格变更的影响 实例类型 规格变更类型 实例规格变更的影响 单机、主备和读写分离实例 扩容/缩容 Redis 4.0及以上版本基础版实例，扩容期间连接会有秒级中断，大约1分钟的只读，缩容期间连接不会中断。 Redis 3.0实例，规格变更期间连接会有秒级中断，5~30分钟只读。 Redis企业版实例，规格变更期间连接会有秒级中断，大约1分钟的只读。 如果是扩容，只扩大实例的内存，不会提升CPU处理能力。 单机实例不支持持久化，变更规格不能保证数据可靠性。在实例变更后，需要确认数据完整性以及是否需要再次填充数据。如果有重要数据，建议先把数据用迁移工具迁移到其他实例备份。 主备和读写分离实例缩容前的备份记录，缩容后不能使用。如有需要请提前下载备份文件，或缩容后重新备份。 Proxy和Cluster集群实例 扩容/缩容 水平扩容（分片数增加）： 连接不中断，但会占用CPU，导致性能有20%以内的下降。 分片数增加时，会新增数据节点，数据自动负载均衡到新的数据节点，访问时延会增大。 水平缩容（分片数减少）： 分片数减少时，会删除节点。Cluster集群实例缩容前，请确保应用中没有直接引用这些删除的节点，否则可能导致业务访问异常。 删除节点会导致连接闪断，请确保您的客户端应用具备重连机制和处理异常的能力，否则在变更规格后可能需要重启客户端应用。 垂直扩容（分片数不变，分片容量增加）： 如果节点所在的虚拟机内存容量不足，会发生节点迁移，迁移时业务连接会有闪断和只读。 如果虚拟机内存容量充足，则直接扩大节点容量，对业务无影响。 说明： Redis 3.0版本集群实例不支持垂直扩缩容，Redis 4.0及以上版本集群实例如需扩容集群实例单分片容量，请联系技术支持添加垂直扩容特性白名单。 垂直缩容（分片数不变，分片容量减少）：无影响。 实例缩容前，每个节点的已用内存要小于缩容后节点最大内存的70%，否则将不允许变更。 实例规格变更期间，可能会进行数据迁移，访问时延会增大。Cluster集群请确保客户端能正常处理MOVED和ASK命令，否则会导致请求失败。 实例规格变更期间，如果有大批量数据写入导致节点内存写满，将会导致变更失败。 在实例规格变更前，请先使用缓存分析中的大key分析，确保实例中没有大key存在，否则在规格改变后，节点间进行数据迁移的过程中，单个key过大（≥512MB）会触发Redis内核对于单key的迁移限制，造成数据迁移超时失败，进而导致规格变更失败，key越大失败的概率越高。 Cluster集群实例扩容或缩容时，请确保客户端开启集群拓扑自动刷新配置，否则在变更后需要重启客户端。Lettuce客户端开启集群拓扑自动刷新配置请参考Lettuce客户端连接Cluster集群实例中的示例。 实例规格变更前的备份记录，变更后不能使用。如有需要请提前下载备份文件，或变更后重新备份。 主备、读写分离和Cluster集群实例 副本数变更 Cluster集群实例增加或删除副本时，请确保客户端开启集群拓扑自动刷新配置，否则在变更后需要重启客户端。Lettuce客户端开启集群拓扑自动刷新配置请参考Lettuce客户端连接Cluster集群实例中的示例。 删除副本会导致连接中断，需确保您的客户端应用具备重连机制和处理异常的能力，否则在删除副本后需要重启客户端应用。增加副本不会连接中断。 当副本数已经为实例支持的最小副本数时，不支持删除副本。

实例类型变更须知 表1 DCS实例类型变更明细 实例版本 支持的实例变更类型 变更须知及影响 Redis 3.0 单机实例变更为主备实例 连接会有秒级中断，大约1分钟左右的只读。 主备实例变更为Proxy集群实例 如果Redis 3.0主备实例数据存储在多DB上，或数据存储在非DB0上，不支持变更为Proxy集群；数据必须是只存储在DB0上的主备实例才支持变更为Proxy集群。 连接会中断，5~30分钟只读。 Memcached 单机实例变更为主备实例 会有秒级业务中断、大约1分钟只读。 Redis 4.0/5.0/6.0 主备实例或读写分离实例变更为Proxy集群实例 变更为proxy集群时，需要评估proxy集群的多DB使用限制和命令使用限制对业务的影响。具体请参考proxy集群使用多DB限制，实例受限使用命令。 变更前实例的已用内存必须小于变更后最大内存的70%，否则将不允许变更。 如果变更前实例的已用内存超过总内存的90%，变更的过程中可能会导致部分key逐出。 变更完成后需要对实例重新创建告警规则。 如果原实例是主备实例，请确保应用中没有直接引用只读IP或只读 域名 。 请确保您的客户端应用具备重连机制和处理异常的能力，否则在变更规格后有可能需要重启客户端应用。 变更规格过程中会有秒级业务中断、大约1分钟只读，建议在业务低峰时进行变更。 Proxy集群实例变更为主备实例或读写分离实例 Redis 4.0/5.0/6.0 主备实例变更为读写分离实例 说明： 读写分离实例暂不支持直接变更为主备实例。 目前只支持主备实例变更为相同容量的读写分离实例，小于4G规格的主备实例不支持变更为读写分离实例。 如果变更前实例的已用内存超过总内存的90%，变更的过程中可能会导致部分key逐出。 变更完成后需要对实例重新创建告警规则。 请确保主备实例的应用中没有直接引用只读IP或只读域名。 请确保您的客户端应用具备重连机制和处理异常的能力，否则在变更规格后有可能需要重启客户端应用。 变更规格过程中会有秒级业务中断，建议在业务低峰时进行变更。 主备实例如果创建了ACL账号，不支持变更为读写分离实例。 Redis 6.0如果开启了SSL链路加密传输，不支持变更为读写分离实例。 除了上表中提到的实例外，其他实例类型目前不支持实例类型的变更，若您想实现跨实例类型的规格变更，可参考使用迁移任务在线迁移Redis实例进行操作。 实例类型变更后支持的命令，请参考对应的开源命令兼容性。

DCS实例如何缩容？ DCS实例支持扩容和缩容明细如下表1。 表1 实例规格变更明细 缓存类型 单机实例 主备实例 Cluster集群实例 Proxy集群实例 读写分离实例 Redis 3.0 支持扩容和缩容 支持扩容和缩容 - 仅支持扩容 - Redis 4.0 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 5.0 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 6.0 基础版 支持扩容和缩容 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 6.0 企业版 - 支持扩容和缩容 - - - Memcached 支持扩容和缩容 支持扩容和缩容 - - - 实例扩容、缩容操作请参考规格变更。 如果Redis 3.0 Proxy集群需要缩容，可以先进行数据备份，然后另外创建对应规格的Proxy集群实例，使用备份文件导入方式，将备份数据文件导入到新的Proxy集群实例。待数据迁移完成后，再释放原来规格的Proxy集群实例。在线迁移操作，可以参考备份文件导入方式。 父主题： 扩容缩容与实例升级

Redis实例是否支持版本升级，如Redis 4.0升级到Redis 5.0？ 暂不支持直接升级。Redis不同版本的底层架构不一样，在创建Redis实例时，确定Redis版本后，不能修改，如Redis 4.0的实例不能升级到Redis 5.0。 如您的业务需要使用Redis高版本的功能特性，可重新创建高版本Redis实例，然后将原有Redis实例的数据迁移到高版本实例上。具体数据迁移操作，可参考数据迁移指南。 父主题： 扩容缩容与实例升级

API概览 类型 说明 RSU管理 包括RSU的创建、删除、修改、查询接口。 雷达管理 包括RSU型号的创建、删除、修改、查询接口。 Edge应用管理 包括Edge应用的创建、删除、修改、查询接口。 Edge应用版本管理 包括Edge应用版本的创建、删除、修改、更新、查询接口。 边缘应用管理 包括边缘应用的部署、删除、升级、查询接口。 信号机管理 包括Edge的创建、删除、修改、查询等接口。 长期交通事件管理 包括业务通道的创建、删除、修改、查询接口。 车辆管理 包括IPC的查询接口。 IPC管理 包括雷达信息的查询接口。 RSU型号管理 包括信号机的获取、创建、删除、修改接口。 业务通道管理 包括车辆的获取、创建、删除、修改接口。 Edge管理 包括交通事件的创建、删除、修改、查询接口。 历史交通消息管理 创建即时交通事件。 即时交通事件管理 包括数据转发配置的创建、删除、更新、查询接口。 数据转发 包括bsm、rsi、rsm、spat、statistics、tracks消息转发。 数据转发配置管理 下发交通消息给设备侧，当前仅支持下发SPAT消息给RSU设备。 交通消息下发 查询历史交通事件。 父主题： 应用侧API参考

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

Token认证 Token是服务端生成的一串字符串，作为客户端进行请求的一个令牌。第一次登录后，服务器生成一个Token并将此Token返回给客户端，以后客户端只需带上这个Token前来请求数据即可，无需再次带上用户名和密码。Token有效期是24小时，从客户端获取开始算起（24小时是相对时间），需要使用同一个Token鉴权时，建议缓存起来使用，避免频繁调用。在Token过期前，务必刷新Token或重新 获取Token ，否则Token过期后会在服务端鉴权失败。 如果您获取Token多次，以最新的为准，前面的Token会被覆盖并失效。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxxxxxx" } } } } 加粗的斜体字段需要根据实际值填写，其中username为IAM用户名，domainname为IAM用户所属帐号名，********为IAM用户的登录密码，xxxxxxxxxxxxxxxxxx为IAM用户所属账号的项目名称，如“cn-north-1”，您可以参考我的凭证页面获取。 接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值为获取到的Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 POST https://ocv2x-api.cn-north-4.myhuaweicloud.com/v1/{project_id}/traffic-events Content-Type: application/json X-Auth-Token: ABCDEFJ.... Instance-Id: xxxxxx 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的帐号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token额作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表格内容。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Instance-Id 路网数字化服务 的实例ID，请参考获取Instance-Id获取实例ID。 否 部分接口调用要求必选。 c7ff8b76-9e6c-46c1-863e-a2225bb637ef project-id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点中获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 DRIS.00000002 Invalid input. %s 请求参数不合法 请排查请求参数是否符合文档定义。 400 DRIS.00000012 Resource create failed. 开通资源失败 请联系华为工程师分析解决。 400 DRIS.00000013 Resource already exist. This domain is already create resource. 资源已经存在 资源已经存在，请勿重复开通资源。 400 DRIS.00010001 The RSU ESN already exists. RSU esn已经存在 请更换esn后重试。 400 DRIS.00010005 The RSU model name already exists. RSU型号名称已存在 请更换名称后重试。 400 DRIS.00020002 Invalid input, event type invalid. 事件分类和事件类型不匹配 请参考国标交通事件编码填写。 400 DRIS.00020003 Invalid input, no tenant id found! 帐号ID不合法 请联系华为工程师分析解决。 400 DRIS.00030001 Invalid input. No matching RSU found for this event. 事件位置范围内未匹配到RSU 请检查事件位置是否正确。 400 DRIS.00100001 The number of RSU connection to Edges have reached the upper limit. RSU可关联的Edge数量达上限 请参考修改一个RSU资源调整RSU可关联的Edge数量。 400 DRIS.00100003 The EdgeApps are repeated. Edge App已经存在 请更换edge_app_id后重试。 400 DRIS.00120002 IPC ESN duplicate IPC设备已经存在 请更换esn后重试。 400 DRIS.00130003 Create install command failed. 生成边缘节点安装命令失败 请联系华为工程师分析解决。 400 DRIS.00200000 Instance not found. dris实例不存在 请确认携带的instance_id是否正确。 400 DRIS.00210001 Unknown system mode. 未知的系统模式 请确认携带的systemMode是否正确。 400 DRIS.00210003 Incremental updates are not supported. License不支持增量更新 请尝试使用全量更新操作。 400 DRIS.00210008 ESN not match can not apply. 激活license时esn匹配失败 请联系华为工程师分析解决。 400 DRIS.00280001 The Vehicle VehicleId already exists. 车辆ID已经存在 请更换vehicle_id后重试。 400 DRIS.00290001 The TrafficController TrafficControllerId already exists. 信号机设备已存在 请更换traffic_controller_id后重试。 400 DRIS.00340002 The file not found! 文件不存在 请确认对应file_id的文件是否已经导入到平台。 400 DRIS.00340003 The file has imported! 文件中的设备已经创建 请更换文件后重试。 400 DRIS.00350004 The linkAssetRelation file not found! 该file_id对应的路段设备关系文件不存在 请确认对应file_id的文件是否已经导入到平台后重试。 401 DRIS.00000004 Token is invalid. token不合法 请排查请求中的token是否正确或是否过期。 401 DRIS.00000007 Resource unauthorized. The instance does not belong to this authorized user. 资源未授权 请确认是否已开通资源。 401 DRIS.00000010 Resource unauthorized. URL's project id doesn't match token. 资源访问受限 请检查携带的token是否有权限访问url中指定project_id的项目。 403 DRIS.00000005 Resource limit reached. 请求的资源配额已达上限 请联系华为工程师分析解决。 403 DRIS.00000006 Resource is frozen. 资源已被冻结 请联系华为工程师分析解决。 403 DRIS.00000009 Operation not allowed. The user does not have the permission of this API. 无权访问此API 请联系华为工程师确认用户的权限策略。 403 DRIS.00010004 Rsu resource reach limit. RSU可关联的Edge数量达上限 请参考修改一个RSU资源调整RSU可关联的Edge数量。 403 DRIS.00020004 Traffic event resource reach limit. 交通事件数量达上限 请删除一些交通事件后重试。 403 DRIS.00031005 Simulation task is running! 仿真任务正在执行中 请在任务执行完成后再操作。 403 DRIS.00031006 Simulation task lack scenes! 仿真任务缺少任务应用场景 请根据任务类型补全对应场景。 403 DRIS.00130001 Request forbidden. The system app $edgetepa must be deployed first. 部署边缘应用失败 请先部署边缘系统应用。 403 DRIS.00130005 The EdgeApp cannot be deleted because it has associated DataChannels. 删除边缘应用失败 Edge设备的业务通道存在时无法直接删除边缘应用，请先删除业务通道后重试。 403 DRIS.00150001 Max configurations (10) exceeded. 租户数据转发配置资源（Kafka）数量达上限 请删除未使用的数据转发配置后重试。 403 DRIS.00150002 The broker in your request already exists. Check your Kafka configurations. 数据转发配置中的broker地址已经存在 请更换broker地址及用户名密码后重试。 403 DRIS.00190001 The algorithm model for this function of this road network already exists. 算法模型已经存在 请确认对应road_network_id和model_function的算法模型是否已经添加到平台。 403 DRIS.00190002 The algorithm model of this version is in use. 指定版本的算法模型已经在使用中 请确认此版本的算法模型处于非使用状态后重试 403 DRIS.00200002 Forbidden to operate instance. 禁止操作dris实例 请联系华为工程师分析解决。 403 DRIS.00280003 Vehicle resource reach limit. 车辆数量达上限 请联系华为工程师分析解决。 403 DRIS.00290003 TrafficController resource reach limit. 信号机设备数量达上限 请联系华为工程师分析解决。 403 DRIS.00350001 The number of devices of the same data type on one link exceeds the limit! 该路段下同种数据类型的绑定设备数量超过限制 请先解绑该路段下对应数据类型的已绑定设备后重试。 403 DRIS.00350002 The total number of linkAssetRelation exceeds the limit! 绑定路段设备关系总数超过限制 请先解绑部分未使用的路段设备关系后重试。 403 DRIS.00350003 The linkAssetRelation not bound! 该路段设备关系未绑定 请确认当前输入的link_id,esn,data_type对应的路段设备关系已绑定。 403 DRIS.00350005 The number of subTasks in the file exceeds limit 该文件下对应的子任务数量超过限制 请减少文件中的待操作的数据条数以符合限制后重试。 403 DRIS.00350006 The linkAssetRelation task is running! 已有路段设备任务正在执行 请在当前任务完成后再重试。 404 DRIS.00000011 Resource not found. 资源不存在 请确认是否已开通资源。 404 DRIS.00010002 The RSU not found. RSU不存在 请确认对应的rsu_id或esn是否已经在平台创建RSU。 404 DRIS.00010003 Rsu model not found. RSU型号不存在 请确认对应的rsu_model_id是否已经在平台创建RSU型号。 404 DRIS.00020001 This traffic event is not found. 交通事件不存在 请确认对应的event_id是否已经在平台创建交通事件。 404 DRIS.00040001 Area config not found. 区域配置不存在 请确认对应的area_code是否已经在平台添加区域配置。 404 DRIS.00080001 Rule config not found 交通事件规则配置不存在 请确认对应的event_type或position_id是否已经在平台新增规则。 404 DRIS.00090001 Edge not found. Edge设备不存在 请确认对应的v2x_edge_id是否已经在平台创建Edge设备。 404 DRIS.00100002 The EdgeApp not found. Edge App不存在 请确认对应的edge_app_id是否已经在平台创建Edge App。 404 DRIS.00100004 The EdgeAppVersion not found. Edge App版本不存在 请确认对应的version是否已经在平台创建Edge App版本。 404 DRIS.00120001 This camera does not exist. IPC设备不存在 请确认对应camera_id的IPC设备是否已经添加到平台。 404 DRIS.00130002 The V2XEdgeApp not found 边缘应用不存在 请确认对应v2x_edge_id和edge_app_id的边缘应用是否已经部署。 404 DRIS.00130004 DataChannel not found 业务通道不存在 请确认指定Edge设备（v2x_edge_id）是否已经在平台创建业务通道 404 DRIS.00150003 Kafka config not found 数据转发配置资源（Kafka）不存在 请确认对应的forwarding_config_id是否已经在平台创建数据转发配置。 404 DRIS.00170001 Not Found. 地图区间不存在 请确认地图区间是否已经在平台添加。 404 DRIS.00180001 Not Found. 资源不存在 请确认是否已开通资源。 404 DRIS.00190003 The algorithm model not found. 算法模型不存在 请确认对应model_id的算法模型是否已经添加到平台。 404 DRIS.00210000 The license file does not exist and cannot be updated. License文件不存在 请确认携带的lsn是否正确。 404 DRIS.00210004 ESN not found. license esn不存在 请联系华为工程师分析解决。 404 DRIS.00220001 The file not found. 文件不存在 请联系华为工程师分析解决。 404 DRIS.00230001 The interaction not found. 对接系统不存在 请确认对应interaction_id的对应系统是否已经在平台配置。 404 DRIS.00240001 The ITS asset not found. 交通设施不存在 请确认对应its_asset_id的交通设施是否已经在平台添加。 404 DRIS.00250001 Link not found. 路段不存在 请确认对应link_id的路段是否已经在平台添加。 404 DRIS.00260001 The Road network not found. 路网不存在 请确认对应road_network_id的路网是否已经在平台生成。 404 DRIS.00270001 The control strategy not found. 管控策略不存在 请确认对应strategy_id的管控策略是否已经在平台下发。 404 DRIS.00280002 The Vehicle not found. 车辆不存在 请确认对应vehicle_id的车辆资源是否已经在平台创建。 404 DRIS.00290002 The TrafficController not found. 信号机设备不存在 请确认对应traffic_controller_id的信号机设备是否已经在平台创建。 404 DRIS.00300001 The datasource not found. 数据源不存在 请检查data_source_id是否正确。 404 DRIS.00310001 The simulation task not found! 仿真任务不存在 请确认对应task_id的仿真任务是否已经在平台创建。 404 DRIS.00320001 The common scene not found! 仿真任务普通场景不存在 请确认对应task_id和common_id的普通场景仿真任务是否已经在平台创建。 404 DRIS.00320002 The accident scene not found! 仿真任务事故场景不存在 请确认对应task_id和accident_id的事故场景仿真任务是否已经在平台创建。 404 DRIS.00320003 The construction scene not found! 仿真任务施工场景不存在 请确认对应task_id和construction_id的施工场景仿真任务是否已经在平台创建。 404 DRIS.00320004 The common speed-limit scene not found! 仿真任务限速场景不存在 请确认对应task_id和speed_limit_id的限速场景仿真任务是否已经在平台创建。 404 DRIS.00320005 The common flow-control scene not found! 仿真任务匝道流控场景不存在 请确认对应task_id和flow_control_id的匝道流控场景仿真任务是否已经在平台创建。 404 DRIS.00320006 The emergency-lan-open scene not found! 仿真任务开放应急车道场景不存在 请确认对应task_id和emergency_lan_open_id的开放应急车道场景仿真任务是否已经在平台创建。 404 DRIS.00330001 The statistics result not found! 仿真任务的统计结果不存在 请检查任务是否已经执行成功。 404 DRIS.00330002 The detector result not found! 仿真任务的检测器结果不存在 请检查任务是否已经执行成功且检测器已经存在。 404 DRIS.00340001 The task not found! 任务不存在 请确认对应task_id的任务是否已经在平台创建。 404 DRIS.00350007 The linkAssetRelation task not found! 该task_id对应的路段设备关系任务不存在 请确认对应task_id的路段设备关系任务是否已经在平台创建。 405 DRIS.00000003 Method not allowed. Http request method not supported, just supports: %s Http Method不合法 请排查Http Method是否与文档一致。 429 DRIS.00000008 Request reached the maximum rate limit %s. 请求被流控 请在流控范围内请求接口。 500 DRIS.00000001 Internal server error. %s 服务器内部错误 请联系华为工程师分析解决。 500 DRIS.00200001 Instance create failed. %s 创建dris实例失败 请联系华为工程师分析解决。 500 DRIS.00200003 Create vpc endpoint failed. 创建vpcep失败 请联系华为工程师分析解决。 500 DRIS.00200004 Create iotda out channel failed. 创建IoTDA的网络通道失败 请联系华为工程师分析解决。 500 DRIS.00210002 Update device limit failed. 更新设备数上限配置时发生错误 请联系华为工程师分析解决。 500 DRIS.00210005 Get key file content failed. 获取license key文件失败 请联系华为工程师分析解决。 500 DRIS.00210006 Get revoke code failed. 更新license为失败状态时获取失效码失败 请联系华为工程师分析解决。 500 DRIS.00210007 Parse license failed. license解析失败 请联系华为工程师分析解决。

概述 欢迎使用路网数字化服务（Digital Road Infrastructure Service，DRIS），本服务通过车路协同、物联网等智能技术，打造人、车、路、云的全面协同，构建协作式的智慧交通，使能协同式的自动驾驶，给出行者提供更安全、更高效、更便捷的出行，给管理者提供全路段感知、全天候通行、全过程管控的智慧运营。 您可以使用本文档提供的API对道路设备和感知事件等资源进行相关操作，如RSU资源管理、交通事件资源管理等，支持的全部操作请参见API概览。业务数据开放接口的数据集定义满足标准编号为YD/T 3709-2020的《基于LTE的车联网无线通信技术 消息层技术要求》以及标准编号为 TCS AE 53-2017的《合作式智能运输系统 车用通信系统应用层及应用数据交互标准》的标准要求。 在调用DRIS API之前，请确保已经充分了解路网数字化服务相关概念，详细信息请参见产品介绍。 父主题： 使用前必读

组合应用 ROMA Connect可通过组合应用进行应用的复合集成，通过开放的API和事件通道进行应用的多次组装，形成新的组合应用，实现业务快速复制创新，形成千人千面的集成体验。内置海量连接器，提供各种数据库、API、消息、SaaS应用等的连接器封装。同时提供自定义连接器框架，可快速按需扩展定制；提供丰富的预置组合应用集成模板和生态连接器，联合各行各业的伙伴积累行业资产，开箱即用。 表5 组合应用功能 功能 简介 组合应用 在画布页面对各种触发器、连接器、处理器进行编排和配置，组合成新的组合应用。 智能助手 智能助手通过NLP (Natural Language Processing) 机器学习，理解用户输入的集成业务需求，匹配系统支持的触发器、连接器和数据处理器，生成组合应用。可以对生成的组合应用进一步配置和编排，最后构建，部署上线。 组合应用模板 提供丰富的预置组合应用集成模板，帮助用户快速便捷的创建组合应用。 引用变量 用户在编辑设计组合应用时，可以通过变量的方式快速引用流任务中的输入输出信息和配置信息，帮助用户便捷高效的设计组合应用。 在线调试 创建组合应用和工作流并配置完成后，可对工作流进行在线调试，实时查看各个节点的运行信息，便于后续对工作流进行调整以满足业务需求。 监控统计 提供组合应用运行记录、系统日志、运行监控等监控信息统计。

LINK 设备集成（LINK）是ROMA Connect的设备集成组件。设备集成使用MQTT标准协议连接设备，帮助企业快速、简单地实现设备云端管理。 例如工业场景中，设备的信息和生产过程中的参数比较分散。生产线出现故障时，如果靠人工采集每一台设备的信息与参数，定位问题的过程缓慢。设备集成能够连接设备和IT系统、大数据平台，将设备的运行状态等信息上传到IT系统或大数据平台，实现所有设备的信息可视化，一旦生产线出现故障，企业能够快速定位问题。通过配置LINK的规则引擎，把设备参数的极限值输入到设备引擎里面，如果设备的实时参数一直在向极限值接近，就发出告警信息，提醒用户停止设备，对设备进行维护和保养。 表4 LINK功能 功能 简介 发布和订阅消息 LINK支持标准的MQTT协议，企业可以使用开源的标准MQTT设备端SDK将设备轻松接入云端，进行消息的发布和订阅。 实现设备与后端各应用的消息互通 用户可以在控制台配置规则引擎实现设备与其他设备、后端、其他云服务的消息互通。 LINK支持规则引擎转发数据到消息集成MQS。第三方服务通过MQS服务获取数据，实现设备与第三方服务的异步消息通信。 支持海量设备低延时接入 LINK支持Broker水平扩展，支持百万设备长连接。 支持设备与应用之间的双向同步 LINK支持物模型定义，模型与设备影子绑定。用户可以基于设备影子实现设备与应用之间配置数据、状态数据的双向同步。 一方面，用户可以通过API将配置参数设置到设备影子里，设备在线或上线时，都可以从设备影子获取配置参数。另一方面，设备可以将最新状态上报到设备影子。用户查询设备状态时，只需查询设备影子，而不必与设备进行直接网络通信。 保证信息传输的安全 LINK提供设备、应用授权认证及Topic的双向绑定授权，保障设备安全与唯一性，提供TLS标准的数据传输通道保障消息传输通道的安全。

FDI 快速数据集成FDI（Fast Data Integration，简称FDI）是ROMA Connect的数据集成组件。FDI支持多种数据源（文本、消息、API、关系型数据和非关系型数据等）之间的灵活、快速、无侵入式的数据集成，可以实现跨机房、跨数据中心、跨云的数据集成方案，并能自助实施、运维、监控集成数据。 例如集团企业场景中，企业与合作伙伴使用的数据源不一样，难以形成企业之间有效的信息传输。FDI提供了多种数据源之间转换的方式，支持MySQL、Kafka、API等主流格式之间的转换。 表1 FDI功能 功能 简介 数据集成任务的生命周期管理 FDI支持修改数据集成任务的信息、查看数据集成任务的运行报告、查看数据集成任务的运行日志、查看数据集成任务状态，完成数据集成任务的生命周期管理功能。 灵活的数据读写 支持 MySQL、文本文件、消息、API等多种数据的分片读取和写入。 如果服务意外中断 ，修复服务之后FDI支持自动修复任务。 支持任务调度、任务监控、任务中断续读。 可靠的数据传输通道 FDI可以持续监测数据通道中的数据，支持100个以上的线程并发执行。FDI实时监测消息队列把数据实时写入目标队列。 任务调度 FDI提供全面、灵活、高可用的任务调度服务，支持通过API或以消息方式进行数据集成。按照时间、数据数量等任务触发规则来调度任务。根据任务配置，为插件分配任务，并监控和记录任务的执行状态。 企业根据不同的业务需求，可以选择不同的数据集成方式： 实时增量集成适用于需要实时监控数据变化的业务场景，例如收集生产线上设备的实时参数。 实时全量集成适用于需要实时监控所有历史数据的业务场景，例如统计供应商合作伙伴的出货量。 定时增量集成适用于监控一段时间内数据变化的业务场景，例如企业采用新的生产策略后，验证生产效率是否达到预期效果。 定时全量集成适用于监控一段时间内所有历史数据的业务场景，例如统计上下班高峰期内出入园区的车辆数目。 监控告警 对创建的数据集成任务的运行情况进行监控，并对异常的任务进行处理，保证业务正常运行。