华为云用户手册

请求示例 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 表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 { "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 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

响应参数 状态码： 201 表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

响应示例 状态码： 201 Created { "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" ], "topic_prefix" : "prefix", "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "status" : "OFFLINE", "model_ids" : [ "40f96952-ea2f-4a10-8a92-e641aa1c6e49" ], "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12: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" } }

请求示例 POST https://{endpoint}/v1/{project_id}/forwarding-configs Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "forwarding_type" : "kafka", "forwarding_config" : { "kafka_config" : { "topic_prefix" : "prefix", "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:10000" ], "username" : "1234567890", "password" : "1234567890", "model_ids" : [ "40f96952-ea2f-4a10-8a92-e641aa1c6e49" ] } } }

响应示例 状态码： 200 OK { "count" : 1, "forwarding_configs" : [ { "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" } } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 参数说明：满足查询条件的记录总数。 最小值：0 最大值：10000 forwarding_configs Array of ForwardingConfig objects 参数说明：转发配置的列表。 数组长度：0 - 50 表5 ForwardingConfig 参数 参数类型 描述 forwarding_type String 参数说明：转发配置的类型。 取值范围：当前仅支持“kafka、mrskafka”。 kafka_config KafkaConfigResponseDTO object 参数说明：Kafka配置信息。 mrs_kafka_config MrsKafkaConfigResponseDTO object 参数说明：mrsKafka配置信息。 表6 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 表7 CertificateInfo 参数 参数类型 描述 effective_date String 证书生效日期 expiry_date String 证书失效日期 表8 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

响应参数 状态码： 200 表3 响应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：运行中

请求示例 POST https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/apps Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "edge_app_id" : "test-app", "app_version" : "1.0.0" }

响应参数 状态码： 201 表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：运行中

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

手动导入 通过主页面的“更多功能”选项或单击左上角搜索框旁边的，可以展示当前支持的导入选项，可根据需要选择。 导入文件 选择响应格式的文件并上传，然后选择文件中系统识别出来的接口和数据模型导入。 一个文件导入后，将会视为一个根目录，一个根目录中不允许存在URL相同的接口。 Postman支持Collections和Environment数据集ZIP包的全量导入，也支持单个Collection文件导入。 Postman支持接口和接口用例的前置脚本及后置脚本导入。 导入URL 选择“导入Swagger URL”，输入URL，即可完成文档导入。 通过Swagger URL导入时，需要填写json数据文件的URL，而非Swagger UI的URL。

套餐包说明 您可以通过包年包月（套餐包）的方式，提前购买使用额度和时长，获取更多的优惠。超出套餐包的部分自动转按需计费。如何购买套餐包？ 套餐包到期后，不会影响您在消息&短信服务上的使用和数据安全。您只要保证云服务账号上有足够的余额，系统会自动以按需计费的模式进行结算。 套餐包与账号绑定，不支持跨账号使用。 套餐包不支持退订，建议您在购买套餐包前提前规划资源的使用额度和时长。 套餐包购买后即时生效，到期后自动失效，不支持延期，套餐包使用后剩余资源不支持退订。 套餐包仅支持抵扣套餐包购买后产生的费用，不支持抵扣套餐包购买前产生的费用。 套餐包用量即将耗尽时，若需要继续发送短信，请重新购买新的套餐包。

计费规则 发送短信优先扣除已购买套餐包内的额度，超出部分按需计费（套餐包额度计算在阶梯内）。 如果先后购买了两个同类型的套餐包，优先使用先生效的套餐包，前一个套餐包用量耗尽，才会使用后一个套餐包。 短信字数超过规定长度时，系统会将一条长短信拆分成多条短信进行计算，短信条数计算详情请参见短信发送规则。 按不同类型的短信模板，扣除不同类型套餐包内的额度。如您使用行业短信套餐包，则系统会扣除您行业短信套餐包内的额度，不影响推广短信套餐包的额度。 验证码短信和通知短信计费方式一致。 短信发送成功才计费。

套餐包抵扣顺序 抵扣顺序原则 当购买了多个相同属性的套餐包，会按照套餐包过期时间顺序进行抵扣，优先抵扣过期时间近的套餐包。 若您一次性购买多个套餐包，则套餐包生效时间和结束时间相同。 示例 场景 某客户分别购买了两个行业短信包 套餐包A：规格1万条，2024年5月1日生效，购买时长1年，即2025年5月1日过期。 套餐包B：规格10万条，2024年5月10日生效，购买时长1年，即2025年5月10日过期。 抵扣顺序 2024年5月1日~2024年5月9日 只有套餐包A生效。 使用套餐包A抵扣，超出1万条部分按需计费。 2024年5月10日~2025年4月30日 套餐包A、B同时生效，叠加使用。 优先使用套餐包A抵扣，超出1万条部分使用套餐包B抵扣，超出11万条部分按需计费。 2025年5月1日~2025年5月9日 套餐包A过期，只有套餐包B生效。 使用套餐包B抵扣，超出10万条部分按需计费。 2025年5月10日~ 套餐包A、B均已过期，此时为按需计费。