华为云用户手册

数据库账号权限要求 在使用DRS进行迁移时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时迁移任务。不同类型的迁移任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 表2 数据库账号权限 类型名称 全量迁移 全量+增量迁移 源数据库连接账号 需要具备如下最小权限： SELECT、SHOW VIEW、EVENT。 用户迁移时，如果源数据库为8.0版本，需要有mysql.user表的SELECT权限；如果为5.7及以下版本，则需要mysql系统库的SELECT权限。 需要具备如下最小权限： SELECT、SHOW VIEW、EVENT、LOCK TABLES、REPLICATION SLAVE、REPLICATION CLIENT。 用户迁移时，如果源数据库为8.0版本，需要有mysql.user表的SELECT权限；如果为5.7及以下版本，则需要mysql系统库的SELECT权限。 目标数据库连接账号 需要具备如下最小权限： SELECT、CREATE、ALTER、DROP、DELETE、INSERT、UPDATE、INDEX、EVENT、CREATE VIEW、CREATE ROUTINE、TRIGGER、REFERENCES、WITH GRANT OPTION。当目标库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。 用户迁移时，需要有mysql库的SELECT、INSERT、UPDATE、DELETE权限。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请尽快修改DRS任务中的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表2中为DRS任务所需的最小权限，如果需要DRS任务迁移grant授权的情况下，请确保DRS任务的连接账号本身具备对应权限，否则可能因为grant授权执行失败导致目标库对应用户缺少授权。例如DRS任务的连接账号本身不要求process权限，如果需要通过DRS任务迁移process授权则需要保证DRS任务的连接账号具备该权限。

支持的迁移对象范围 在使用DRS进行迁移时，不同类型的迁移任务，支持的迁移对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对迁移对象进行自动检查。 表3 支持的迁移对象 类型名称 使用须知 迁移对象范围 支持选择表级、库级或实例级（全部迁移）。 支持数据库、表、用户、视图、索引、约束、函数、存储过程、触发器（TRIGGER）和事件（EVENT）的迁移。 仅支持MyISAM和InnoDB表的迁移。 不支持系统库的迁移以及事件状态的迁移。 不支持宽松模式可以写入但严格模式下无法写入的非标浮点类型的数据的迁移，这种非标浮点类型数据可能会有无法命中的风险导致数据迁移失败。 全量和增量迁移不支持隐藏列（INVISIBLE），隐藏列是MySQL 8.0.23开始支持的特性，例如： CREATE TABLE `test11` ( `id` int NOT NULL, `c1` int DEFAULT NULL /*!80023 INVISIBLE */, PRIMARY KEY (`id`));

注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考DRS预检查项一览表。除了预检查项目之外，您还需要注意的事情如表4所示 表4 注意事项 类型名称 使用和操作限制 源数据库限制 源数据库不支持mysql binlog dump命令。 源数据库不支持reset master或reset master to命令，可能会导致DRS任务失败或者数据不一致。 相互关联的数据对象要确保同时迁移，避免迁移因关联对象缺失，导致迁移失败。 不支持外键级联操作。当外键是普通索引的时候，可能会导致表结构创建失败，建议改成唯一索引。 由于MySQL本身限制，若源库的一次性事件（EVENT）设定的触发时间在迁移开始前，该事件（EVENT）不会迁移到目标库。 使用限制 通用： 整个迁移过程中，不建议修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。 整个迁移过程中，不允许对正在迁移中的目标数据库进行修改操作（包括但不限于DDL、DML操作）。 整个迁移过程中，不允许源库写入binlog格式为statement的数据。 整个迁移过程中，不允许源库执行清除binlog的操作。 整个迁移过程中，不允许在源库创建库名为ib_logfile的数据库。 需要DRS任务迁移索引的情况下，目标库对应表上不能存在同名但不同列信息的索引。全量阶段DRS会忽略对应表上已存在的同名索引，增量阶段DDL根据索引名操作索引时会触发错位问题。 全量迁移阶段： 任务启动和全量数据迁移阶段，请不要在源数据库执行DDL操作，否则可能导致任务异常。 增量迁移阶段： 选择表级对象迁移时，增量迁移过程中不支持对表进行重命名操作。 增量迁移阶段，不支持源数据库进行恢复到某个备份点的操作（PITR）。 增量迁移阶段，支持断点续传功能，在主机系统崩溃的情况下，对于非事务性的无主键的表可能会出现重复插入数据的情况。 增量迁移阶段，支持DDL语句。 结束任务： 任务正常结束： 在结束迁移任务时，将进行所选事件（EVENT）和触发器（TRIGGER）的迁移。请确保任务结束前，不要断开源和目标数据库的网络连通性，并在结束任务时关注迁移日志上报的状态，达到数据库完整迁移效果。 任务强制结束： 强制结束将直接释放DRS资源，不会进行触发器、事件的迁移，请参考手工迁移触发器、事件。如果需要DRS进行触发器、事件迁移，请先修复DRS任务，待任务状态正常后，再正常结束任务。 常见故障排查： 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考“故障排查”章节进行排查。 其他限制 若专属计算集群不支持4vCPU/8G或以上规格实例，则无法创建迁移任务。 对于源数据库和目标数据库的版本有差异的迁移链路，由于不同版本之间的部分特性差异，可能会出现语法兼容性问题，详情可参考MySQL不同版本之间的语法差异。 多对一场景下，创建迁移任务时，目标库读写设置需要跟已有任务设置为一致。 由于无主键表缺乏行的唯一性标志，网络不稳定时涉及少量重试，表数据存在少量不一致的可能性。 对于表中的物理生成列，如果列是根据一个时间类型生成的，会存在此列数据不一致的可能性。 不支持目标数据库恢复到全量迁移时间段范围内的PITR操作。 源库和目标库为RDS for MySQL实例时，不支持带有TDE特性并建立具有加密功能表。 如果目标库MySQL不支持TLS1.2协议，或者为版本较低的自建库（低于5.6.46或在5.7.0-5.7.28之间），需提交运维申请才能使用SSL测试连接。 当目标数据库为5.7版本时，因为版本限制，json类型中的浮点数会丢失小数点后末位的0，存在精度损失导致内容对比不一致。 在创建DRS任务之前，如果源或者目标数据库实例开启并设置了SQL限流规则，可能会导致DRS任务失败。

注意事项 为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考DRS预检查项一览表。除了预检查项目之外，您还需要注意的事情如表4所示 表4 注意事项 类型名称 使用和操作限制 源数据库限制 源库不支持阿里云RDS的只读副本。 如果源数据库为自建库，并且安装了Percona Server for MySQL 5.6.x或Percona Server for MySQL 5.7.x时，内存管理器必须使用Jemalloc库，以避免因系统表频繁查询带来的内存回收不及时，并最终导致数据库Out of Memory问题。 源数据库不支持mysql binlog dump命令。 源数据库不支持reset master或reset master to命令，可能会导致DRS任务失败或者数据不一致。 相互关联的数据对象要确保同时迁移，避免迁移因关联对象缺失，导致迁移失败。 不支持外键级联操作。当外键是普通索引的时候，可能会导致表结构创建失败，建议改成唯一索引。 由于MySQL本身限制，若源库的一次性事件（EVENT）设定的触发时间在迁移开始前，该事件（EVENT）不会迁移到目标库。 使用限制 通用： 整个迁移过程中，不建议修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。 整个迁移过程中，不允许对正在迁移中的目标数据库进行修改操作（包括但不限于DDL、DML操作）。 整个迁移过程中，不允许源库写入binlog格式为statement的数据。 整个迁移过程中，不允许源库执行清除binlog的操作。 整个迁移过程中，不允许在源库创建库名为ib_logfile的数据库。 整个迁移过程中，不允许修改目标数据库主节点的浮动IP到只读节点。如果进行了修改，数据将会写入到只读节点，导致目标数据库和源数据库数据不一致。 需要DRS任务迁移索引的情况下，目标库对应表上不能存在同名但不同列信息的索引。全量阶段DRS会忽略对应表上已存在的同名索引，增量阶段DDL根据索引名操作索引时会触发错位问题。 全量迁移阶段： 任务启动和全量数据迁移阶段，请不要在源数据库执行DDL操作，否则可能导致任务异常。 增量迁移阶段： 选择表级对象迁移时，增量迁移过程中不支持对表进行重命名操作。 增量迁移阶段，不支持源数据库进行恢复到某个备份点的操作（PITR）。 增量迁移阶段，支持断点续传功能，在主机系统崩溃的情况下，对于非事务性的无主键的表可能会出现重复插入数据的情况。 增量迁移阶段，支持DDL语句。 结束任务： 任务正常结束： 在结束迁移任务时，将进行所选事件（EVENT）和触发器（TRIGGER）的迁移。请确保任务结束前，不要断开源和目标数据库的网络连通性，并在结束任务时关注迁移日志上报的状态，达到数据库完整迁移效果。 任务强制结束： 强制结束将直接释放DRS资源，不会进行触发器、事件的迁移，请参考手工迁移触发器、事件。如果需要DRS进行触发器、事件迁移，请先修复DRS任务，待任务状态正常后，再正常结束任务。 常见故障排查： 在任务创建、启动、全量同步、增量同步、结束等过程中，如有遇到问题，可先参考“故障排查”章节进行排查。 其他限制 若专属计算集群不支持4vCPU/8G或以上规格实例，则无法创建迁移任务。 目标数据库实例必须是GaussDB(for MySQL)主备实例。 多对一场景下，创建迁移任务时，目标库读写设置需要跟已有任务设置为一致。 由于无主键表缺乏行的唯一性标志，网络不稳定时涉及少量重试，表数据存在少量不一致的可能性。 对于表中的物理生成列，如果列是根据一个时间类型生成的，会存在此列数据不一致的可能性。 不支持目标数据库恢复到全量迁移时间段范围内的PITR操作。 源库和目标库为RDS for MySQL实例时，不支持带有TDE特性并建立具有加密功能表。 如果源库MySQL不支持TLS1.2协议，或者为版本较低的自建库（低于5.6.46或在5.7.0-5.7.28之间），需提交运维申请才能使用SSL测试连接。 在创建DRS任务之前，如果源或者目标数据库实例开启并设置了SQL限流规则，可能会导致DRS任务失败。 迁移任务目标数据库可以设置“只读”和“读写”。 只读：目标数据库实例将转化为只读、不可写入的状态，迁移任务结束后恢复可读写状态，此选项可有效的确保数据迁移的完整性和成功率，推荐此选项。 读写：目标数据库可以读写，但需要避免操作或接入应用后会更改迁移中的数据（注意：无业务的程序常常也有微量的数据操作），进而形成数据冲突、任务故障、且无法修复续传，充分了解要点后可选择此选项。

数据库账号权限要求 在使用DRS进行迁移时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时迁移任务。不同类型的迁移任务，需要的账号权限也不同，详细可参考表2进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 表2 数据库账号权限 类型名称 全量迁移 全量+增量迁移 源数据库连接账号 需要具备如下最小权限： SELECT、SHOW VIEW、EVENT。 用户迁移时，如果源数据库为8.0版本，需要有mysql.user表的SELECT权限；如果为5.7及以下版本，则需要mysql系统库的SELECT权限，源数据库为阿里云数据库，则账户需要同时具有mysql.user和mysql.user_view的SELECT权限。 需要具备如下最小权限： SELECT、SHOW VIEW、EVENT、LOCK TABLES、REPLICATION SLAVE、REPLICATION CLIENT。 用户迁移时，如果源数据库为8.0版本，需要有mysql.user表的SELECT权限；如果为5.7及以下版本，则需要mysql系统库的SELECT权限，源数据库为阿里云数据库，则账户需要同时具有mysql.user和mysql.user_view的SELECT权限。 目标数据库连接账号 需要具备如下最小权限： SELECT、CREATE、ALTER、DROP、DELETE、INSERT、UPDATE、INDEX、EVENT、CREATE VIEW、CREATE ROUTINE、TRIGGER、REFERENCES、WITH GRANT OPTION。当目标库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。 用户迁移时，需要有mysql库的SELECT、INSERT、UPDATE、DELETE权限。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请尽快修改DRS任务中的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表2中为DRS任务所需的最小权限，如果需要DRS任务迁移grant授权的情况下，请确保DRS任务的连接账号本身具备对应权限，否则可能因为grant授权执行失败导致目标库对应用户缺少授权。例如DRS任务的连接账号本身不要求process权限，如果需要通过DRS任务迁移process授权则需要保证DRS任务的连接账号具备该权限。

支持的迁移对象范围 在使用DRS进行迁移时，不同类型的迁移任务，支持的迁移对象范围不同，详细情况可参考表3。DRS会根据用户选择，在“预检查”阶段对迁移对象进行自动检查。 表3 支持的迁移对象 类型名称 使用须知 迁移对象范围 支持选择表级、库级或实例级（全部迁移）。 支持数据库、表、用户、视图、索引、约束、函数、存储过程、触发器（TRIGGER）和事件（EVENT）的迁移。 仅支持MyISAM和InnoDB表的迁移。 不支持系统库的迁移以及事件状态的迁移。 不支持宽松模式可以写入但严格模式下无法写入的非标浮点类型的数据的迁移，这种非标浮点类型数据可能会有无法命中的风险导致数据迁移失败。 全量和增量迁移不支持隐藏列（INVISIBLE），隐藏列是MySQL 8.0.23开始支持的特性，例如： CREATE TABLE `test11` ( `id` int NOT NULL, `c1` int DEFAULT NULL /*!80023 INVISIBLE */, PRIMARY KEY (`id`));

约束限制 所有链路均支持修改连接密码。 目前仅MySQL和GaussDB(for MySQL)为源且连接方式为输入IP地址的任务，在增量阶段支持修改IP、端口、用户名信息。当源库进行某些操作导致IP地址、端口、用户名变化时，可通过此功能更新为正确的信息。 修改IP功能适用于源库IP地址变化场景，修改前后的IP必须属于同一个数据实例，否则可能导致任务失败或者数据不一致。 连接信息修改后，将实时生效，不会清空目标数据库的数据。

方法一 在“实时同步管理”页面，选择需要修改同步对象的任务，单击操作列的“编辑”按钮。 图1 编辑实时同步对象 进入“设置同步”页面，修改需要同步的对象，单击“下一步”。 选择对象时可对展开的库进行搜索，搜索支持正则表达式。 当对象名称包含空格时，名称前后的空格不显示，中间如有多个空格只显示一个空格。 选择的同步对象名称中不能包含空格。 在“数据加工”页面，可参考数据加工章节，为新增加表设置相关规则。 任务再编辑时，已经同步的表不支持修改加工规则。 在“预检查”页面，进行同步任务预校验，校验是否可进行。 查看检查结果，如有不通过的检查项，需要修复不通过项后，单击“重新校验”按钮重新进行任务预校验。 预检查不通过项处理建议请参见《数据复制服务用户指南》中的“预检查不通过项修复方法”。 预检查完成后，且所有检查项结果均通过时，单击“下一步”。 所有检查项结果均通过时，若存在请确认项，需要阅读并确认详情后才可以继续执行下一步操作。 在“任务确认”页面，确认同步任务信息无误后，单击“启动任务”，提交同步任务。 返回“实时同步管理”，在同步任务列表中，当前任务状态显示为“增量同步”，并生成任务状态为“任务变更中”的子任务，待子任务变更完成后，开始对编辑后的同步对象进行增量同步。

DRS任务创建后支持修改源或目标数据库吗 DRS在任务创建后、启动前的配置状态时，支持修改源或者目标数据库。 入云链路：支持修改源数据库，不支持修改目标数据库。目标数据库为创建任务时选择的实例，不支持更换，仅支持修改数据库连接信息（用户名和密码）。 出云链路：支持修改目标数据库信息，不支持修改源数据库。源数据库为创建任务时选择的实例，不支持更换，仅支持修改数据库连接信息（用户名和密码）。 自建-自建链路：支持修改源和目标数据库信息。 DRS在任务提交启动后，源和目标数据库均不支持更换，仅支持修改数据库连接密码。 父主题： 通用操作

授权操作说明 创建用户 操作方式： CREATE USER 'username'@'host' IDENTIFIED BY 'password'; · username：待创建的账号。 · host：允许该账号登录的主机，如果允许该账号从任意主机登录数据库，可以使用%。 · password：账号的密码。 例如：授予drsmigration账号具备所有数据库和表的所有权限，并允许从任意主机登录数据库，命令如下。 CREATE USER 'drsmigration'@'%' IDENTIFIED BY 'Drs123456'; 授予相应权限 操作方式： GRANT privileges ON databasename.tablename TO 'username'@'host' WITH GRANT OPTION; flush privileges; · privileges：授予该账号的操作权限，如SELECT、INSERT、UPDATE等，如果要授予该账号所有权限，则使用ALL · databasename：数据库名。如果要授予该账号具备所有数据库的操作权限，则使用*。 · tablename：表名。如果要授予该账号具备所有表的操作权限，则使用*。 · username：待授权的账号。 · host：允许该账号登录的主机，如果允许该账号从任意主机登录，则使用%。 · WITH GRANT OPTION：授予该账号使用GRANT命令的权限，该参数为可选。 例如：创建一个账号，账号名为drsmigration，密码为Drs123456，并允许从任意主机登录数据库，命令如下。 GRANT ALL ON *.* TO 'drsmigration'@'%';

权限要求 源和目标库的连接账号需要具有登录权限，如果没有该账号，可以通过如下方式创建，以user1为例。 参考语句：CREATE USER 'user1'@'host' IDENTIFIED BY 'password'; DRS的实时迁移、实时同步、实时灾备功能的权限要求，表1 权限要求中以user1为例提供参考语句。 表1 权限要求及参考语句 功能模块 源/业务数据库 目标/灾备数据库 实时迁移 全量迁移权限要求： SELECT、SHOW VIEW、EVENT。 参考语句：GRANT SELECT, SHOW VIEW, EVENT ON *.* TO 'user1'; 全量+增量迁移权限要求： SELECT、SHOW VIEW、EVENT、LOCK TABLES、REPLICATION SLAVE、REPLICATION CLIENT。 其中，REPLICATION SLAVE、REPLICATION CLIENT是全局权限，必须单独开启。参考语句如下： GRANT REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'user1'; SELECT、SHOW VIEW、EVENT、LOCK TABLES是非全局权限，参考语句如下： GRANT SELECT, SHOW VIEW, EVENT, LOCK TABLES ON [待迁移数据库].* TO 'user1'; 全量迁移权限要求： SELECT、CREATE、ALTER、DROP、DELETE、INSERT、UPDATE、INDEX、EVENT、CREATE VIEW、CREATE ROUTINE、TRIGGER、REFERENCES、WITH GRANT OPTION。当目标库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。 参考语句：GRANT SELECT, CREATE, ALTER, DROP, DELETE, INSERT, UPDATE, INDEX, EVENT, CREATE VIEW, CREATE ROUTINE, TRIGGER ON *.* TO 'user1' WITH GRANT OPTION; 全量+增量迁移权限要求： SELECT、CREATE、ALTER、DROP、DELETE、INSERT、UPDATE、INDEX、EVENT、CREATE VIEW、CREATE ROUTINE、TRIGGER、REFERENCES、WITH GRANT OPTION。当目标库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。 参考语句：GRANT SELECT, CREATE, ALTER, DROP, DELETE, INSERT, UPDATE, INDEX, EVENT, CREATE VIEW, CREATE ROUTINE, TRIGGER, REFERENCES ON [待迁移数据库].* TO 'user1' WITH GRANT OPTION; 实时同步 SELECT、SHOW VIEW、EVENT、LOCK TABLES、REPLICATION SLAVE、REPLICATION CLIENT。 其中，REPLICATION SLAVE、REPLICATION CLIENT是全局权限，必须单独开启。参考语句如下： GRANT REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'user1'; SELECT、SHOW VIEW、EVENT、LOCK TABLES是非全局权限，参考语句如下： GRANT SELECT, SHOW VIEW, EVENT, LOCK TABLES ON [待同步数据库].* TO 'user1'; SELECT、CREATE、DROP、DELETE、INSERT、UPDATE、ALTER、CREATE VIEW、CREATE ROUTINE、REFERENCES。 参考语句：GRANT SELECT, CREATE, DROP, DELETE, INSERT, UPDATE, ALTER, REFERENCES ON [待同步数据库].* TO 'user1'; 实时灾备 SELECT、CREATE、ALTER、DROP、DELETE、INSERT、UPDATE、TRIGGER、REFERENCES、SHOW VIEW、EVENT、INDEX、LOCK TABLES、CREATE VIEW、 CREATE ROUTINE、 ALTER ROUTINE、 CREATE USER、RELOAD、REPLICATION SLAVE、REPLICATION CLIENT、WITH GRANT OPTION，RDS for MySQL实例的root账户默认已具备上述权限。当业务数据库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。 参考语句：GRANT SELECT,CREATE,ALTER,DROP,DELETE,INSERT,UPDATE,TRIGGER,SHOW VIEW,EVENT,INDEX,LOCK TABLES,CREATE VIEW,CREATE ROUTINE,ALTER ROUTINE,CREATE USER,RELOAD,REPLICATION SLAVE,REPLICATION CLIENT ON *.* TO 'user1'; SELECT、CREATE、ALTER、DROP、DELETE、INSERT、UPDATE、TRIGGER、REFERENCES、SHOW VIEW、EVENT、INDEX、LOCK TABLES、CREATE VIEW、 CREATE ROUTINE、 ALTER ROUTINE、 CREATE USER、RELOAD、REPLICATION SLAVE、REPLICATION CLIENT、WITH GRANT OPTION，RDS for MySQL实例的root账户默认已具备上述权限。当灾备数据库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。 参考语句：GRANT SELECT,CREATE,ALTER,DROP,DELETE,INSERT,UPDATE,TRIGGER,REFERENCES,SHOW VIEW,EVENT,INDEX,LOCK TABLES,CREATE VIEW,CREATE ROUTINE,ALTER ROUTINE,CREATE USER,RELOAD,REPLICATION SLAVE,REPLICATION CLIENT ON *.* TO 'user1'@'%' WITH GRANT OPTION; 请在以上参考语句后执行flush privileges;使授权生效。

计费标准 表1 按需计费标准 计费项 计费说明 配置费（必选） 指计算和存储资源及数据处理的费用，按照实际使用时长计费，以自然小时为单位整点计费，不足一小时按照实际使用时长计费。 弹性公网IP费用（可选） 指公网访问产生的数据处理和数据流量费用。如果创建公网网络任务，您需要购买弹性公网IP。 华为云DRS配置费用详情，请参见产品价格详情。您可以通过DRS提供的价格计算器，选择您需要的配置规格，来快速计算出参考价格。

基础指标：node-exporter指标 介绍通过中间件Exporter上报到AOM的node-exporter指标的类别、名称、含义等信息。 表1 CCE/自建K8s集群容器指标 Job名称 指标 指标含义 node-exporter node_filesystem_size_bytes 挂载的文件系统占用空间 node_filesystem_readonly 只读挂载的文件系统 node_filesystem_free_bytes 挂载的文件系统剩余空间 node_filesystem_avail_bytes 挂载的文件系统可用空间 node_cpu_seconds_total 节点CPU时间 node_network_receive_bytes_total 累积接收数据总量 node_network_receive_errs_total 接收时遇到的错误累积计数 node_network_transmit_bytes_total 累积传输数据总量 node_network_receive_packets_total 接收数据包的累积计数 node_network_transmit_drop_total 传输时丢弃的累积计数 node_network_transmit_errs_total 传输时遇到的错误累积计数 node_network_up 网卡的状态 node_network_transmit_packets_total 传输数据包的累积计数 node_network_receive_drop_total 接收时丢弃的累积计数 go_gc_duration_seconds 数据来自调用debug.ReadGCStats()，调用该函数时，会将传入参数GCStats结构体的PauseQuantile字段设置为5，这样函数将会返回最小、25%、50%、75% 和最大，这5个GC暂停时间百分位数。然后prometheus Go客户端根据返回的GC暂停时间百分位数、以及NumGC和PauseTotal变量创建摘要类型指标。 node_load5 节点5分钟CPU负载 node_filefd_allocated 已分配的文件描述符 node_exporter_build_info NodeExporter构建信息 node_disk_written_bytes_total 写入成功的字节总数 node_disk_writes_completed_total 写入完成的次数 node_disk_write_time_seconds_total 写入花费的总时长 node_nf_conntrack_entries 链接状态跟踪表分配的数量 node_nf_conntrack_entries_limit 链接状态跟踪表总量 node_processes_max_processes PID限制值 node_processes_pids PID个数 node_sockstat_TCP_alloc 已分配的TCP套接字数量 node_sockstat_TCP_inuse 正在使用的TCP套接字数量 node_sockstat_TCP_tw 等待关闭的TCP连接数 node_timex_offset_seconds 时钟时间偏移 node_timex_sync_status 节点时钟同步状态 node_uname_info 节点uname信息 node_vmstat_pgfault /proc/vmstat中的pgfault node_vmstat_pgmajfault /proc/vmstat中的pgmajfault node_vmstat_pgpgin /proc/vmstat中的pgpgin node_vmstat_pgpgout /proc/vmstat中的pgpgout node_disk_reads_completed_total 读取完成的次数 node_disk_read_time_seconds_total 读取花费的总时长 process_cpu_seconds_total 该指标计算使用到utime（Go进程执行在用户态模式下的滴答数）和stime（Go进程执行在内核态时候的滴答数，例如系统调用时），参数的单位为jiffies，jiffy描述了两次系统定时器中断之间的滴答时间。process_cpu_seconds_total等于utime和stime之和除以USER_HZ。即将程序滴答总数除以 Hz（每秒滴答数）得到就是操作系统运行该进程的总时间（以秒为单位）。 node_disk_read_bytes_total 读取成功的字节总数 node_disk_io_time_weighted_seconds_total 执行I/O所花费的加权秒数 node_disk_io_time_seconds_total I/O总耗时 node_disk_io_now 当前运行的I/O数量 node_context_switches_total 上下文切换次数 node_boot_time_seconds 节点开机时间 process_resident_memory_bytes 即RSS（Resident Set Size），指的是常驻内存集，是进程实际使用的内存，他不包括分配但未使用的内存，也不包括换出的内存页面，但包含共享内存。 node_intr_total 节点中断总数 node_load1 节点1分钟CPU负载 go_goroutines 通过runtime.NumGoroutine()调用获取，基于调度器结构sched和全局allglen变量计算得来。由于sched结构体的所有字段可能并发的更改，因此最后会检查计算的值是否小于1，如果小于1，那么返回1。 scrape_duration_seconds 采集scrape target花费的时间 node_load15 节点15分钟CPU负载 scrape_samples_post_metric_relabeling metric被重设标签后，剩余sample数量 node_netstat_Tcp_PassiveOpens 从LISTEN 状态直接转换到SYN-RCVD 状态的TCP连接数 scrape_samples_scraped scrape target暴露的sample数量 node_netstat_Tcp_CurrEstab 当前状态为ESTABLISHED 或CLOSE-WAIT 的TCP 连接数 scrape_series_added scrape target新增加的系列数 node_netstat_Tcp_ActiveOpens 从CLOSED 状态直接转换到SYN-SENT 状态的TCP连接数 node_memory_MemTotal_bytes 节点内存总量 node_memory_MemFree_bytes 节点空闲内存 node_memory_MemAvailable_bytes 节点可用内存 node_memory_Cached_bytes 节点页面缓存中的内存 up scrape target的状态 node_memory_Buffers_bytes 节点缓冲区的内存 父主题： 指标总览

请求示例 PUT https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "name" : "v2xEdge001", "description" : "v2xEdge 001", "local_segment_rsus" : [ { "segment_id" : "1", "rsu_esn" : "13518098671442480164720973683901" }, { "segment_id" : "2", "rsu_esn" : "13518098671442480164720973683901" }, { "segment_id" : "3", "rsu_esn" : "98238558220689235608785517764662" } ] }

响应示例 状态码： 200 OK { "v2x_edge_id" : "ab6cb4ca-bc7a-4b3d-8629-7212c5d9a6b0", "name" : "NAMEMC007", "description" : "test", "esn" : "esn123", "ip" : "127.0.0.1", "port" : "65535", "hardware_type" : "ATLAS", "server_protocol_type" : "http", "server_cert" : null, "position_description" : "K08", "location" : { "lat" : 0, "lon" : 0 }, "local_rsus" : [ ], "local_segment_rsus" : [ { "segment_id" : "1", "rsu_esn" : "13518098671442480164720973683901" }, { "segment_id" : "2", "rsu_esn" : "13518098671442480164720973683901" }, { "segment_id" : "3", "rsu_esn" : "98238558220689235608785517764662" } ], "edge_general_config" : { "avp_enabled" : true, "rsm_enabled" : true, "time_compensate" : true, "log_level" : "off", "road_detection_length" : 10, "ramp_detection_length" : 10, "edge_authentications" : [ { "user_name" : "dris_user" } ], "gat1400_username" : null, "user_name" : "dris_user" }, "edge_advance_config" : { "key" : "value", "key1" : { "inner_key1" : "inner_value1" } }, "status" : "INSTALLED", "node_id" : "536434354358674544874543587", "created_time" : "2020-09-01T01:37:01Z", "last_modified_time" : "2020-09-01T01:37:01Z" }

响应参数 状态码： 200 表8 响应Body参数 参数 参数类型 描述 v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge 最小长度：0 最大长度：255 name String 参数说明：名称。 取值范围：长度不低于1不超过128，只允许中文、字母、数字、下划线（_）、连接符（-）的组合。 description String 参数说明：Edge描述。 取值范围：长度不超过255，只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。 最小长度：0 最大长度：255 esn String 参数说明：设备编码，全局唯一。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 ip String 参数说明：网络IP，例如127.0.0.1。 port Integer ITS800,ATLAS 端口号 最小值：0 最大值：65535 hardware_type String 参数说明：硬件类型。 取值范围：ITS800 或者 ATLAS server_protocol_type String 参数说明：v2xedge作为服务端的协议类型。 取值范围：http 或者 https 缺省值：http server_cert String 参数说明：v2xedge作为服务端，pem格式的证书。 最小长度：0 最大长度：4096 position_description String 参数说明：安装位置编码，由用户自定义。 取值范围：长度不低于1不超过128，只允许字母、数字、下划线（_）的组合。 location Location object 参数说明：经纬度坐标。 local_rsus Array of strings 参数说明：Edge关联的本地RSU列表。 最大长度：255 数组长度：0 - 32 local_segment_rsus Array of LocalSegmentRsu objects 参数说明：Edge管理的分段所关联的本地RSU列表。 数组长度：0 - 32 edge_general_config EdgeGeneralConfigInResponse object Edge通用配置。 edge_advance_config Object Edge高级配置，Json格式 最大长度：4096 status String "参数说明：状态。 取值范围： UNINSTALLED： 待部署 INSTALLED：部署中 OFFLINE：离线 ONLINE：在线： UPGRADING：升级中 DELETING：删除中 node_id String 边缘管理服务返回的node_id，用于关联EdgeManager的资源 最小长度：0 最大长度：255 created_time String 参数说明：创建时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 last_modified_time String 参数说明：创建时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 表9 Location 参数 参数类型 描述 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 lon Number 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-180 最大值：180 表10 LocalSegmentRsu 参数 参数类型 描述 segment_id String 参数说明：分段Id，填写雷达设备对应序号（sequence_no）。 取值范围：数字字符串。 最小长度：1 最大长度：4 rsu_esn String 参数说明：RSU的设备序列号。 取值范围：只允许长度不小于1、最大为64，字母、数字、下划线（_）的组合。 最小长度：1 最大长度：64 表11 EdgeGeneralConfigInResponse 参数 参数类型 描述 avp_enabled Boolean 参数说明：AVP场景。 rsm_enabled Boolean 参数说明：RSM上报：默认不上报。 time_compensate Boolean 参数说明：时延补偿：是否启动Edge时延补偿功能。 rsi_positioning_enabled Boolean 参数说明：RSI事件定位功能。 log_level String 参数说明：应用日志级别 取值范围：on/off，默认关闭。 缺省值：off road_detection_length Double 参数说明：道路检测长度，单位：米。 最小值：1 最大值：1000 ramp_detection_length Double 参数说明：匝道检测长度，单位：米。 最小值：1 最大值：1000 gat1400_username String 参数说明：edge作为服务端单用户鉴权的用户名。如需配置多套鉴权用户，请使用edge_authentications。不能和edge_authentications同时使用，建议使用edge_authentications。 取值范围：长度不小于8，不大于32，只允许数字字母下划线组合，且不能以数字下划线开头，不能有中文和特殊字符，gat1400用户名不能与gat1400密码相同。 edge_authentications Array of ResponseEdgeAuthentication objects 参数说明：edge作为服务端的多用户鉴权信息，和gat1400_username（单个鉴权用户）不可同时使用，建议使用该字段。 数组长度：0 - 10 user_name String 参数说明：ITS800鉴权用的用户名。 取值范围：长度不超过255，只允许字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 表12 ResponseEdgeAuthentication 参数 参数类型 描述 user_name String 参数说明：edge接口鉴权用户名。 取值范围：长度不小于8，不大于32，只允许数字字母下划线组合，且不能以数字下划线开头，不能有中文和特殊字符，用户名不能与密码相同。

响应示例 状态码： 200 OK { "forwarding_type" : "kafka", "kafka_config" : { "kafka_config_id" : "1234567890", "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow", "realtime-traffic", "forecast-traffic", "recommended-strategies", "executed-strategies", "strategy-evaluations", "confirmed-event", "traffic-event", "compositive-tracks", "model-data", "request-strategies" ], "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "topic_prefix" : "abc", "status" : "ONLINE", "model_ids" : [ "40f96952-ea2f-4a10-8a92-e641aa1c6e49" ], "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-13T12:12:12Z" }, "mrs_kafka_config" : { "kafka_config_id" : null, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow", "realtime-traffic", "forecast-traffic", "recommended-strategies", "executed-strategies", "strategy-evaluations", "confirmed-event", "traffic-event", "compositive-tracks", "model-data", "request-strategies" ], "brokers" : [ "127.0.0.1:10000" ], "username" : null, "status" : null, "authentication" : false, "model_ids" : [ "40f96952-ea2f-4a10-8a92-e641aa1c6e49" ], "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" } }

请求示例 PUT https://{endpoint}/v1/{project_id}/forwarding-configs/{forwarding_config_id}?forwarding_type={forwarding_type} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "kafka_config" : { "topic_prefix" : "abc", "user_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow", "realtime-traffic", "forecast-traffic", "recommended-strategies", "executed-strategies", "strategy-evaluations", "confirmed-event", "traffic-event", "compositive-tracks", "model-data", "request-strategies" ], "brokers" : [ "127.0.0.1:1000" ], "username" : "1234567890", "password" : "1234567890", "model_ids" : [ "40f96952-ea2f-4a10-8a92-e641aa1c6e49" ] } }

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 forwarding_type String 参数说明：转发配置的类型。 取值范围：当前仅支持“kafka、mrskafka”。 kafka_config KafkaConfigResponseDTO object 参数说明：Kafka配置信息。 mrs_kafka_config MrsKafkaConfigResponseDTO object 参数说明：mrsKafka配置信息。 表8 KafkaConfigResponseDTO 参数 参数类型 描述 kafka_config_id String 参数说明：每一套Kafka配置的唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 kafka_topics Array of strings 参数说明：kafka的主题列表。 取值范围： v2x-v1-tracks：edge上报的车辆轨迹数据 v2x-v1-bsm：车载T-BOX，RSU上报的BSM消息数据 v2x-v1-rsi：RSU，edge上报的RSI消息数据 v2x-v1-rsm： RSU，edge上报的RSM消息数据 v2x-v1-spat：RSU上报的SPAT消息数据 v2x-v1-edge-flow：edge上报的车流量统计信息数据 数组长度：0 - 7 brokers Array of strings 参数说明：Kafka broker列表。 最小长度：1 最大长度：255 数组长度：1 - 255 username String 参数说明：kafka用户名。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 topic_prefix String 参数说明：Topic前缀。 取值范围：长度不超过255，只允许字母、数字、下划线（_）、连接符（-）的组合。 status String 参数说明：一套kafka的连接状态。 取值范围： OFFLINE：离线 ONLINE：在线 枚举值： OFFLINE ONLINE cert_info CertificateInfo object model_ids Array of strings 参数说明：模型ID列表。 user_topics包含model-data时必选，仅支持非系统、分层为gdm的动态模型。 可通过 GET /{project_id}/models 查询模型列表接口获取。 取值范围：仅支持字母，数字以及中划线（-）的组合，长度为36。 数组长度：1 - 10 created_time String 参数说明：创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z last_modified_time String 参数说明：修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z 表9 CertificateInfo 参数 参数类型 描述 effective_date String 证书生效日期 expiry_date String 证书失效日期 表10 MrsKafkaConfigResponseDTO 参数 参数类型 描述 kafka_config_id String 参数说明：每一套Kafka配置的唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 kafka_topics Array of strings 参数说明：kafka的主题列表。 取值范围： v2x-v1-tracks：edge上报的车辆轨迹数据 v2x-v1-bsm：车载T-BOX，RSU上报的BSM消息数据 v2x-v1-rsi：RSU，edge上报的RSI消息数据 v2x-v1-rsm： RSU，edge上报的RSM消息数据 v2x-v1-spat：RSU上报的SPAT消息数据 v2x-v1-edge-flow：edge上报的车流量统计信息数据 数组长度：0 - 7 brokers Array of strings 参数说明：Kafka broker列表。 最小长度：1 最大长度：255 数组长度：1 - 255 username String 参数说明：mrskafka用户名，若开启安全认证该参数必填。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：0 最大长度：255 status String 参数说明：一套kafka的连接状态。 取值范围： OFFLINE：离线 ONLINE：在线 枚举值： OFFLINE ONLINE authentication Boolean 参数说明：是否开启kerberos安全认证的开关。若开启安全认证则需要先上传kerberos安全认证的凭证。 缺省值：false model_ids Array of strings 参数说明：模型ID列表。 user_topics包含model-data时必选，仅支持非系统、分层为gdm的动态模型。 可通过 GET /{project_id}/models 查询模型列表接口获取。 取值范围：仅支持字母，数字以及中划线（-）的组合，长度为36。 数组长度：1 - 10 created_time String 参数说明：创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z last_modified_time String 参数说明：修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z

功能介绍 升级边缘应用前需确保： Edge处于在线状态。相关方法请参见：“查询Edge”接口。 待升级的应用版本状态已更新至发布。相关方法请参见：“更新应用版本状态”接口。 如升级边缘应用接口调用成功，稍后边缘设备将会自动升级至新版本无需手动操作。自动安装完成后应用将处于运行中的状态。 关于应用在设备侧升级的耗时问题：   从边缘应用升级成功到处于运行中状态的耗时取决于边缘设备所处的网络状况以及应用镜像包的大小，可通过查询边缘应用获取边缘应用部署状态。相关方法请参见：“查询边缘应用”接口。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge。 最小长度：0 最大长度：255 edge_app_id String 参数说明：用户自定义应用唯一ID。 最小长度：1 最大长度：32 app_version String 参数说明：应用版本，比如1.0.0。 最小长度：1 最大长度：32 status String 参数说明：应用部署状态。 取值范围： UNINSTALLED：待部署 INSTALLED：部署中 OFFLINE：离线 ONLINE：在线 UPGRADING：升级中 DELETING：删除中 RUNNING：运行中

响应示例 状态码： 200 OK { "count" : 1, "statistics" : [ { "source" : { "source_type" : "detection", "source_id" : "EDGE0123456789" }, "section_id" : 1, "time" : "2022-09-01T13:10:21Z", "period" : 300, "direction" : 180.5, "flow" : 50, "average_speed" : 70.8, "esn" : "2102312ETX10K7000037", "cross_id" : "cross0123456789", "segment" : { "segment_id" : "1", "lon" : 114.23256, "lat" : 30.121545 }, "traffic_direction" : 0, "road_kind" : 10, "lane_count" : 4, "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 70.8 } ], "lane_flow" : [ { "lane_id" : 10, "flow" : 50, "average_speed" : 73.6, "vehicle_density" : 100, "head_interval" : 100, "space_interval" : 1000, "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 70.8 } ] } ], "occupancy" : [ { "lane_id" : 1, "space_occupancy" : 1, "time_occupancy" : 1 } ] } ] }

请求示例 GET https://{endpoint}/v1/{project_id}/edge-flow?limit={limit}&offset={offset}&from_date={from_date}&to_date={to_date}&edge_id={edge_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:********

响应示例 状态码： 200 OK { "count" : 1, "events" : [ { "event_id" : 11111, "event_source_type" : "RSU", "event_source_id" : 2, "esn" : "2102312ETX10K7000037", "area_code" : 568, "event_class" : "AbnormalTraffic", "event_type" : 100, "cross_id" : 1111, "event_description" : "交通事故", "event_level" : 1, "event_params" : { "speed" : "60" }, "event_position" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "event_position_name" : "深圳深南大道", "reference_paths" : [ { "active_path" : [ { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 } ], "path_radius" : 100 } ], "note" : "交通事件信息", "event_status" : "Invalid", "event_confidence" : 1, "event_ex_info" : { "participants" : [ { "ptc_type" : "unknown", "plate_no" : "粤B12345", "speed" : 3000, "vehicle_class" : 54, "gat_vehicle_class" : "k33", "track_id" : 123456789, "lane_no" : 1, "target_rects" : [ { "camera_code" : "abcd", "camera_ip" : "127.0.0.1", "target_pos" : [ { "left_top_x" : 10, "left_top_y" : 10, "right_bottom_x" : 5, "right_bottom_y" : 5 } ], "time_stamp_diff" : 1664507548437 } ], "start_time" : 1664507548437 } ], "congestion_info" : { "level" : 0, "length" : 200, "start_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "end_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "speed" : 10, "start_time" : 1664507548437, "congestion_lanes_info" : [ { "laneid" : 1, "level" : 0, "length" : 200, "speed" : 10, "start_time" : 1664507548437, "start_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "end_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 } } ] }, "data_source" : { "radar" : [ 0 ], "camera" : [ 1 ] }, "camera_list" : [ { "id" : 0, "ip" : "127.0.0.1" } ] }, "rsu_id" : [ "b58efc27-a6e5-4bca-9d12-c76ecfe3f102" ], "start_time" : "2019-08-28T16:32:24Z", "end_time" : "2019-08-28T16:32:24Z" } ] }

请求示例 GET https://{endpoint}/v1/{project_id}/history-traffic-events?limit={limit}&offset={offset}&from_date={from_date}&to_date={to_date}&event_class={event_class}&event_type={event_type}&event_source={event_source}&event_id={event_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:********

修订记录 发布日期 修订记录 2024-05-20 新增 OBU接收SPAT 修改 信号机上报SPAT，修改OpenSouthSpatData中intersections字段的长度。 2023-12-26 新增 数据转发中，rsi消息体增加congestion_lanes_info、data_source、camera_list字段 数据转发中，statistics消息体增加segment、section_id、lane_count、vehicle_density、head_interval、space_interval字段 数据转发中，tracks消息体增加camera_list字段 修改 RSU上报BSM、RSU上报MAP、RSU上报RSI、RSU上报RSM、RSU上报SPAT、信号机上报SPAT、RSU接收RSI、RSU接收SPAT等接口消息示例调整 2023-11-24 新增 OBU上报BSM OBU接收RSI 修改 RSU上报SPAT接口，修改ReportedIntersectionStateDTO中status、timeConfidence字段的描述。 信号机上报SPAT接口，修改OpenSouthIntersectionStateDTO中time_confidence字段的描述。 2023-06-29 修改 RSU接收SPAT，修正RSUReceivedTimeChangeDetailsDTO中的startTime、likelyEndTime字段的描述，修正ReceivedTimeMark中的参数，由“ReceivedTimeMark”修改为“timeMark”。 2023-06-25 新增 发送信号灯消息 2022-12-08 新增 查询雷达接口 2022-11-10 新增 查询历史交通统计信息列表 获取信号机设备列表 创建信号机设备 删除信号机设备 修改信号机设备 获取车辆列表 创建车辆 删除车辆 修改车辆 2022-03-25 修改 RSU管理、Edge管理、业务通道管理、Edge应用版本管理、长期交通事件管理、IPC管理、RSU型号管理、数据转发配置管理、历史交通事件管理、即时交通事件管理，调整请求示例的格式。 RSU接收RSI，ReceivedPosition3D字段修改lat、lat的描述。 查询长期交通事件列表，修改from_time、to_time的描述。 历史交通事件管理，HistoryTrafficEventDTO字段修改start_time、end_time的描述。 Edge管理，harwareType参数名修改为hardware_type，ModifyV2XEdgeDTO移除hardware_type参数。 长期交通事件管理，TrafficEventDTO字段修改event_params的描述 2022-02-10 修改 RSU型号管理，修改project_id、Instance-Id的描述。 创建RSU型号，修改状态码。 查询RSU型号列表，修改功能介绍，修改limit、manufacturer_name、offset的描述，修改状态码。 查询RSU型号，修改功能介绍，修改rsu_model_id的描述，修改状态码。 修改RSU型号，修改功能介绍，修改rsu_model_id的描述，修改状态码。 删除RSU型号，修改功能介绍，修改rsu_model_id的描述，修改状态码。 RSU管理，修改project_id、Instance-Id的描述，RsuPageDTO字段修改count、rsus的描述，RsuDTO字段修改rsu_id、name、description、ip、location、status、rsu_model_id、related_edge_num、software_version的描述，InnerRsuDTO字段修改rsu_id、name、description、esn、ip、position_description、location、status、rsu_model_id、related_edge_num的描述，AddRsuDTO字段修改description、esn、ip、position_description、related_edge_num、rsu_model_id、secret的描述，ModifyRsuRequestDTO字段修改description、ip、position_description、related_edge_num的描述，ModifyInnerRsuRequestDTO字段修改status、ip、position_description、location、related_edge_num的描述，RsuLocation字段修改lat、lon的描述。 查询RSU列表，修改offset、limit、rsu_id、esn、status、rsu_model_id的描述，修改状态码。 创建RSU，修改状态码。 删除RSU，修改rsu_id的描述，修改状态码。 修改RSU，修改rsu_id的描述，修改状态码。 查询历史交通事件列表，修改project_id、Instance-Id、offset、limit、event_class、event_source的描述，修改响应示例，修改状态码。 Edge管理，修改project_id、Instance-Id的描述，AddV2XEdgeDataChannelDTO字段修改platform_type的描述，PlatformPara字段修改address、passwd的描述，V2XEdgeDataChannelResponseDTO字段修改platform_type、channel_status，EdgeConfigData字段修改v2x_server_ip的描述，CameraStatus字段修改status、calibration_status的描述，RadarStatus字段修改status的描述，StatusData字段修改connect_status的描述，V2XEdgeResponseDTO修改v2x_edge_id、name、description、esn、ip、position_description、camera_ids、radar_ids、local_rsus、status、last_modified_time的描述，V2XEdgeListResponseDTO字段修改v2x_edge_id、name、esn、position_description、status的描述，V2XEdgeDetailResponseDTO字段修改v2x_edge_id、name、description、esn、ip、hardwareType、position_description、cameras、radars、local_rsus、status、channel_status、last_modified_time的描述，AddV2XEdgeDTO字段修改name、description、esn、ip、position_description、camera_ids、radar_ids、local_rsus的描述，ModifyV2XEdgeDTO字段修改description、esn、ip、position_description、camera_ids、radar_ids、local_rsus的描述，Location字段修改lat、lon的描述，IdAndStatus字段修改id、status的描述，CameraInfo字段修改camera_ip的描述，ThirdPartyRsu字段修改esn的描述，SyncAppDataRequest字段修改v2x_edge_id的描述，V2XEdgeInnerResponseDTO字段修改rsus、projcet_id、v2x_id、tenant_id的描述。 查询Edge列表，修改status的描述，修改状态码。 创建Edge，修改状态码。 删除Edge，修改v2x_edge_id的描述，修改状态码。 查询Edge，修改v2x_edge_id的描述，修改状态码。 修改Edge，修改v2x_edge_id的描述，修改状态码。 生成部署应用安装命令，修改v2x_edge_id的描述，修改状态码。 创建业务通道，修改v2x_edge_id的描述，修改状态码。 修改业务通道，修改v2x_edge_id的描述，修改状态码。 查询业务通道，修改v2x_edge_id的描述，修改状态码。 删除业务通道，修改v2x_edge_id的描述，修改状态码。 长期交通事件管理，修改project_id、Instance-Id的描述，TrafficEventDTO字段修改status、event_id、event_source_type、event_class、area_code、event_params、reference_paths、event_position_name的描述，AddTrafficEventDTO字段修改event_source_type、event_source_id、event_class、area_code、event_params、reference_paths、event_position_name的描述，UpdateTrafficEventDTO字段修改event_source_type、event_source_id、event_class、area_code、event_params、reference_paths、event_position_name的描述，InnerTrafficEventDTO字段修改status、event_id、event_source_type、event_source_id、event_class、area_code、event_params、reference_paths、event_position_name。 查询长期交通事件列表，修改limit、area_code、status、event_source_type、event_class、event_id的描述，修改状态码。 创建长期交通事件，修改状态码。 查询长期交通事件，修改event_id的描述，修改状态码。 修改长期交通事件，修改event_id的描述，修改状态码。 删除长期交通事件，修改event_id的描述，修改状态码。 RSU接收RSI，RSUReferencePath字段名修改为RSUReceivedReferencePath。 RSU接收SPAT，PhaseDTO字段名修改为RSUReceivedPhaseDTO，TimeChangeDetailsDTO字段名修改为RSUReceivedTimeChangeDetailsDTO，UTCTimingDTO字段名修改为RSUReceivedUTCTimingDTO。 数据转发配置管理，修改project_id、Instance-Id的描述，AddForwardingConfigRequestDTO字段修改forwarding_type的描述，修改ForwardingConfigRequestDTO、KafkaConfigRequestDTO字段的描述，KafkaConfigRequestDTO字段修改topic_prefix、user_topics、brokers、username、password的描述，KafkaConfigRequestDTO字段修改items参数信息，ForwardingConfig字段修改forwarding_type参数的信息，KafkaConfigPageResponseDTO字段修改count、forwarding_configs的描述，修改KafkaConfigResponseDTO字段的描述，KafkaConfigResponseDTO字段修改kafka_config_id、kafka_topics、brokers、username、password、status、created_time、last_modified_time的描述，KafkaConfigResponseDTO字段修改items参数信息，UpdateKafkaConfigRequestDTO字段修改topic_prefix、user_topics、brokers、username、password的描述，UpdateKafkaConfigRequestDTO字段修改items参数信息。 创建数据转发配置，修改功能介绍，修改状态码。 查询数据转发配置列表，修改forwarding_type、limit的描述，修改状态码。 修改数据转发配置，修改forwarding_type的描述，修改状态码。 查询数据转发配置，修改forwarding_type的描述，修改状态码。 删除数据转发配置，修改功能介绍，修改状态码。 即时交通事件管理，修改project_id、Instance-Id的描述，修改SendConfig、Channel字段的描述，Channel字段修改by_lte_pc5、by_lte_uu的描述，TargetList字段修改target_rsu_ids、target_obu_ids的描述，ImmediateEventDTO字段修改time_stamp、event_class、event_type、event_source、event_source_id、event_radius的描述，ImmediateEventResponseDTO字段修改event_class、event_type、event_source、event_source_id的描述，RtesDTO字段修改rte_id、event_source的描述，Position3D字段修改lat、lon的描述。 创建即时交通事件，修改功能介绍，修改状态码。 IPC管理，修改project_id、Instance-Id的描述，IpcResponseDTO字段修改camera_id、v2x_edge_id、cross_id、focal_type、esn、status的描述，IpcInfoResponseDTO字段修改esn的描述。 查询IPC列表，修改limit、status的描述，修改状态码。 查询IPC，修改camera_id的描述，修改状态码。 Edge应用管理，修改project_id、Instance-Id、v2x_edge_id、edge_app_id的描述，修改X-Domain-Id参数信息。CreateEdgeApplicationRequestDTO字段修改edge_app_id、description的描述，UpdateEdgeApplicationRequestDTO字段修改description的描述，QueryEdgeApplicationVersionResponseDTO字段修改edge_app_id、description、state的描述，QueryEdgeAppVersionBriefResponseDTO字段修改edge_app_id、description、state的描述，CreateEdgeApplicationVersionDTO字段修改description的描述，UpdateEdgeAppVersionDTO字段修改description的描述，UpdateEdgeAppVersionStateDTO字段修改state的描述，PageInfoDTO字段修改offset的描述，QueryApplicationBriefResponseDTO字段修改edge_app_id、description、edge_app_id、app_version的描述，V2XEdgeAppResponseDTO字段修改v2x_edge_id、edge_app_id、status的描述，ModifyV2XEdgeAppDTO字段修改app_version的描述。 创建应用，修改状态码。 查询应用列表，修改edge_app_id、offset、limit的描述，修改状态码。 删除应用，修改状态码。 修改应用，修改状态码。 创建应用版本，修改状态码。 查询应用版本列表，修改offset、limit、state的描述，修改状态码。 查询应用版本，修改状态码。 删除应用版本，修改状态码。 修改应用版本，修改状态码。 更新应用版本状态，修改状态码。 部署边缘应用，修改功能介绍，修改状态码。 查询边缘应用列表，修改offset、limit的描述，修改状态码。 升级边缘应用，修改功能介绍，修改edge_app_id的描述，修改状态码。 查询边缘应用，修改状态码，修改delete参数的描述。 删除边缘应用，修改状态码。 RSU上报SPAT，ReportedIntersectionStateDTO字段修改status的描述。 RSU上报MAP，ReportedLane字段修改maneuvers的描述，ReportedConnectingLane字段修改maneuvers的描述，ReportedLaneAttributes字段修改shareWith、laneType的描述。 2022-01-10 新增 数据转发 消息上报 消息接收 Edge管理，新增ModifyEdgeGeneralConfig字段。 2021-11-10 修改 Edge管理，V2XEdgeResponseDTO新增edge_advance_config字段，V2XEdgeDetailResponseDTO新增edge_advance_config字段，AddV2XEdgeDTO新增edge_advance_config字段，ModifyV2XEdgeDTO新增edge_advance_config字段。 2021-11-01 新增 查询IPC列表 查询IPC 修改 Edge管理，EdgeGeneralConfi新增log_level字段，ModifyV2XEdgeDTO新增port、hardwareType字段，AddV2XEdgeDTO新增port、hardwareType字段，V2XEdgeDetailResponseDTO新增port，hardwareType字段，V2XEdgeResponseDTO新增port、hardwareType字段。 Edge管理，VolumeDTO修改部分字段的示例，ExtDevice修改部分字段的示例，ContainerConfigsDTO修改部分字段的示例，ContainerPortDTO修改部分字段的示例，UpdateEdgeAppVersionDTO修改部分字段的示例。 数据转发配置管理，Instance-Id的required的值修改为false。 Edge管理，Instance-Id的required的值修改为false。 长期交通事件管理，AddTrafficEventDTO修改start_time、end_time字段的校验规则，UpdateTrafficEventDTO修改start_time、end_time字段的校验规则。 历史交通消息管理，新增event_source、cross_id字段。 2021-07-02 修改 Edge管理，扩展RSI description字段。 查询RSU列表，修正name: offset参数描述。 查询历史交通事件列表，修改经纬度精度描述。 2021-05-14 修改 Edge管理，新增rsus字段。 2021-03-30 修改 Edge管理，修改created_time、last_modified_time、channel_status字段，enum参数删除“NULL”值。 RSU管理，新增intersection_id字段，status字段新增“UNKNOWN”状态。 Edge应用管理，修改app_id正则校验。 新增 创建业务通道 修改业务通道 查询业务通道 删除业务通道 2021-03-16 修改 数据转发配置管理，新增InnerKafkaConfigDTO字段。 Edge管理，修改“- UNKONWN”为“- UNKNOWN”。 Edge管理，新增user_name字段、password字段。 Edge管理，移除废弃的AppData、AddAppData、EdgeAppResponseDTO、AddEdgeAppDTO。 Edge管理，新增location{lon,lat}字段，修改platform_type、PlatformPara、address、Location字段。 RSU管理，新增software_version字段。 Edge管理，新增user_name、password字段。 2021-02-20 修改 RSU管理，新增dag_ip字段。 部署边缘应用，原命名“创建边缘应用”修改为“部署边缘应用”。 查询边缘应用列表，修改状态码及描述，修正APIG配置，修改httpVpcEndpoints字段方法。 升级边缘应用，原命名“修改边缘应用”修改为“升级边缘应用”。 查询边缘应用，修改httpVpcEndpoints字段方法。 Edge管理，edge查询接口返回值增加channe_status字段，enum参数新增“- UNKONWN”值。 查询历史交通事件列表，修改APIG请求配置。 Edge应用管理，修改project_id字段描述，修改X-Auth-Token参数描述。 废弃 移除废弃的查询节点配置证书 2021-01-09 新增 RSU型号管理 Edge应用管理 Edge应用版本管理 边缘应用管理 生成部署应用安装命令 查询Edge 2020-12-04 新增 Edge管理 数据转发配置管理 历史交通消息管理 即时交通事件管理 参数说明列表 修改 长期交通事件管理 错误码 获取Instance-Id 2020-08-17 新增 V2X MAP接口 获取Instance-Id 获取应用接入信息 修改 RSU管理 长期交通事件管理 2020-08-10 废弃 Kafka配置接口 V2X MAP接口 即时交通事件分发 V2X HistoryTrafficEvents接口 统计交通事件资源管理 V2X VehicleHistory接口 2020-07-31 新增 Kafka配置接口 V2X MAP接口 即时交通事件分发 V2X HistoryTrafficEvents接口 统计交通事件资源管理 V2X VehicleHistory接口 2020-07-01 新增 补充文档修订记录 2020-05-08 新增 RSU管理 长期交通事件管理

响应示例 状态码： 200 OK { "count" : 1, "apps" : [ { "v2x_edge_id" : "74297d76-6f99-4fe2-a435-1e27a524e4c8", "edge_app_id" : "test-app", "app_version" : "1.0.0", "status" : "RUNNING" } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：满足查询条件的记录数。 最小值：0 最大值：10000 apps Array of V2XEdgeAppResponseDTO objects 参数说明：已部署的边缘应用列表。 数组长度：0 - 20 表5 V2XEdgeAppResponseDTO 参数 参数类型 描述 v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge。 最小长度：0 最大长度：255 edge_app_id String 参数说明：用户自定义应用唯一ID。 最小长度：1 最大长度：32 app_version String 参数说明：应用版本，比如1.0.0。 最小长度：1 最大长度：32 status String 参数说明：应用部署状态。 取值范围： UNINSTALLED：待部署 INSTALLED：部署中 OFFLINE：离线 ONLINE：在线 UPGRADING：升级中 DELETING：删除中 RUNNING：运行中

响应示例 状态码： 200 OK { "forwarding_type" : "kafka", "kafka_config_id" : 1234567890, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow", "realtime-traffic", "forecast-traffic", "recommended-strategies", "executed-strategies", "strategy-evaluations", "confirmed-event", "traffic-event", "compositive-tracks", "model-data", "request-strategies" ], "topic_prefix" : "prefix", "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "status" : "OFFLINE", "authentication" : false, "model_ids" : [ "40f96952-ea2f-4a10-8a92-e641aa1c6e49" ], "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 forwarding_type String 参数说明：转发配置的类型。 取值范围：当前仅支持“kafka、mrskafka”。 kafka_config_id String 参数说明：每一套Kafka配置的唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 kafka_topics Array of strings 参数说明：kafka的主题列表。 取值范围： v2x-v1-tracks：edge上报的车辆轨迹数据 v2x-v1-bsm：车载T-BOX，RSU上报的BSM消息数据 v2x-v1-rsi：RSU，edge上报的RSI消息数据 v2x-v1-rsm： RSU，edge上报的RSM消息数据 v2x-v1-spat：RSU上报的SPAT消息数据 v2x-v1-edge-flow：edge上报的车流量统计信息数据 数组长度：0 - 7 brokers Array of strings 参数说明：Kafka broker列表。 最小长度：1 最大长度：255 数组长度：1 - 255 username String 参数说明：kafka用户名。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 topic_prefix String 参数说明：Topic前缀。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 status String 参数说明：一套kafka的连接状态。 取值范围： OFFLINE：离线 ONLINE：在线 枚举值： OFFLINE ONLINE authentication Boolean 参数说明：是否开启kerberos安全认证的开关。若开启安全认证则需要先上传kerberos安全认证的凭证。 缺省值：false model_ids Array of strings 参数说明：模型ID列表。 user_topics包含model-data时必选，仅支持非系统、分层为gdm的动态模型。 可通过 GET /{project_id}/models 查询模型列表接口获取。 取值范围：仅支持字母，数字以及中划线（-）的组合，长度为36。 数组长度：1 - 10 created_time String 参数说明：创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z last_modified_time String 参数说明：修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z