华为云用户手册

Message示例 { "rsms" : [ { "refPos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "participants" : [ { "ptcType" : "4", "ptcId" : 3, "global_track_id" : 123, "source" : 1, "secMark" : 0, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "speed" : 3000, "heading" : 10000, "size" : { "width" : 200, "length" : 3000, "height" : 40 } } ] } ]}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 rsms 否 Array of RSURSMData objects 参数说明：路侧动态目标物消息列表。 表2 RSURSMData 参数 是否必选 参数类型 描述 refPos 否 ReportedPosition3D object 参数说明：位置信息。 participants 否 Array of RSUParticipantData objects 参数说明：交通参与者列表。应用于RSM消息，表示当前探测到的所有或者部分交通参与者信息。 数组长度：1 - 16 表3 RSUParticipantData 参数 是否必选 参数类型 描述 ptcType 否 String 参数说明：路侧单元检测到的交通参与者类型。 取值范围： "0"：未知类型 "1"：机动车 "2"：非机动车 "3"：行人 "4"： RSU设备 ptcId 否 Integer 参数说明：检测单元设置的临时ID。 最小值：0 最大值：65535 global_track_id 否 Long 参数说明：感知设备生成的唯一车辆id。 最小值：0 最大值：9223372036854775807 source 否 Integer 参数说明：定义交通参与者数据的来源。 取值范围： 0：unknown（未知数据源类型） 1：rsu（RSU自身信息） 2：v2x（参与者自身的v2x广播消息） 3：video（视频传感器） 4：microwaveRadar（微波雷达传感器） 5：loop（地磁线圈传感器） 6：lidar（激光雷达传感器） 7：integrated（类或以上感知数据的融合结果） 最小值：0 最大值：7 secMark 否 Integer 参数说明：以0.1 秒为单位，定义1分钟中的毫秒级时刻。分辨率为1毫秒，有效范围是0~59999。 60000及以上表示未知或无效数值。 最小值：0 最大值：65535 pos 否 ReportedPosition3D object 参数说明：位置信息。 speed 否 Integer 参数说明：车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 heading 否 Integer 参数说明：车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值：0 最大值：28800 size 否 ReportedVehicleSize object 参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 表4 ReportedPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表5 ReportedVehicleSize 参数 是否必选 参数类型 描述 width 否 Integer 参数说明：车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：1023 length 否 Integer 参数说明：车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：4095 height 否 Integer 参数说明：车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值：0 最大值：127

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "source" : { "source_type" : "detection", "source_id" : "705183159624675328_2102312ETX10K7000037" }, "time" : "2020-09-01T01:37:01Z", "section_id" : 1, "period" : 300, "direction" : 180, "flow" : 75, "average_speed" : 72.5, "cross_id" : "cross0123456789", "segment" : { "segment_id" : "1", "lon" : 114.23256, "lat" : 30.121545 }, "esn" : "2102312ETX10K7000037", "traffic_direction" : "0,", "road_kind" : "1,", "has_congestion" : "false,", "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 73.6 }, { "vehicle_class" : 20, "flow" : 25, "average_speed" : 71.4 } ], "occupancy" : [ { "lane_id" : 0, "space_occupancy" : 0.6, "time_occupancy" : 0.5 }, { "lane_id" : 1, "space_occupancy" : 0.6, "time_occupancy" : 0.5 } ], "lane_count" : 4, "lane_flow" : [ { "lane_id" : 10, "flow" : 50, "average_speed" : 73.6, "vehicle_density" : 100, "head_interval" : 100, "space_interval" : 1000 }, { "lane_id" : 20, "flow" : 25, "average_speed" : 71.4, "vehicle_density" : 100, "head_interval" : 100, "space_interval" : 1000 } ] }}

请求示例 POST https://{endpoint}/v1/{project_id}/traffic-controllersContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "traffic_controller_id" : "13229397084005974033576909202199", "esn" : "17598448011929637214623971962555", "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road1", "link_id" : "12345676", "secret" : "secret123456"}

响应示例 状态码： 201 Created { "traffic_controller_id" : "13229397084005974033576909202199", "esn" : "17598448011929637214623971962555", "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road1", "link_id" : "12345676", "status" : "INITIAL", "last_modified_time" : "2022-01-06T09:30:24Z", "created_time" : "2022-01-06T09:30:24Z", "last_online_time" : null}

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 traffic_controller_id String 参数说明：信号机设备ID，全局唯一。 esn String 参数说明：序列号。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 name String 参数说明：名称。 description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 ele Number 参数说明：定义海拔高程，可选，单位为分米。 pos_description String 参数说明：位置说明。 取值范围：长度不超过128，只允许字母、数字、以及_等字符的组合。 installation_mode String 参数说明：架设方式。 取值范围： columnar：柱式 road-side-attach：路侧附着式 cantilever：悬臂式 gantry：门架式 lane-above-attach：车行道上方附着式 road_name String 参数说明：所属道路名称，比如高速名称。 取值范围：长度不超过64，只允许汉字、字母、数字、以及_-等字符的组合。 link_id String 参数说明：信号机设备所属路段ID。 取值范围：长度等于30，只允许大写字母、数字。 status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

响应示例 状态码： 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/jsonX-Auth-Token:********Instance-Id:********

请求示例 POST https://{endpoint}/v1/{project_id}/spat/sendContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "rsu_id" : "834bdeb2-66cf-4c44-badf-74764a93eab1", "spat_content" : { "name" : "spat", "intersections" : [ { "intersection_id" : { "region" : 1, "id" : 15 }, "status" : 0, "phases" : [ { "phase_id" : 1, "phase_states" : [ { "light" : 1, "timing" : { "counting" : { "start_time" : { "time_mark" : 0 }, "min_end_time" : { "time_mark" : 1500 }, "max_end_time" : { "time_mark" : 1540 }, "likely_end_time" : { "time_mark" : 1500 }, "time_confidence" : 180, "next_start_time" : { "time_mark" : 6000 }, "next_duration" : { "time_mark" : 150 } }, "start_time" : 0, "likely_end_time" : 255 } } ] }, { "phase_id" : 2, "phase_states" : [ { "light" : 1, "timing" : { "counting" : { "start_time" : { "time_mark" : 0 }, "min_end_time" : { "time_mark" : 1500 }, "max_end_time" : { "time_mark" : 1540 }, "likely_end_time" : { "time_mark" : 1500 }, "time_confidence" : 180, "next_start_time" : { "time_mark" : 6000 }, "next_duration" : { "time_mark" : 150 } }, "start_time" : 0, "likely_end_time" : 255 } } ] } ] } ] }}

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "rsi_source" : { "rsi_source_type" : "rsu", "rsi_source_id" : "RSU0123456789", "esn" : "2102312ETX10K7000037" }, "rtss" : [ { "rts_id" : 100, "sign_type" : 1, "cross_id" : "cross0123456789", "sign_position" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "sign_description" : "string", "time_details" : { "start_time" : 666, "end_time" : 666, "end_time_confidence" : 10 }, "sign_priority" : 5, "reference_paths" : [ { "active_path" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ], "path_radius" : 100 } ], "reference_links" : [ { "up_stream_node_id" : { "region" : 100, "node_id" : 100 }, "down_stream_node_id" : { "region" : 100, "node_id" : 100 }, "reference_lane" : { "reserve0" : false, "lane1" : false, "lane2" : false, "lane3" : false, "lane4" : false, "lane5" : false, "lane6" : false, "lane7" : false, "lane8" : false, "lane9" : false, "lane10" : false, "lane11" : false, "lane12" : false, "lane13" : false, "lane14" : false, "lane15" : false } } ] } ], "rtes" : [ { "rte_id" : 100, "cross_id" : "cross0123456789", "event_type" : 100, "event_source" : "rsu", "event_position" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "event_radius" : 100, "event_description" : "string", "time_details" : { "start_time" : 666, "end_time" : 666, "end_time_confidence" : 10 }, "event_priority" : 5, "reference_paths" : [ { "active_path" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ], "path_radius" : 100 } ], "reference_links" : [ { "up_stream_node_id" : { "region" : 100, "node_id" : 100 }, "down_stream_node_id" : { "region" : 100, "node_id" : 100 }, "reference_lane" : { "reserve0" : false, "lane1" : false, "lane2" : false, "lane3" : false, "lane4" : false, "lane5" : false, "lane6" : false, "lane7" : false, "lane8" : false, "lane9" : false, "lane10" : false, "lane11" : false, "lane12" : false, "lane13" : false, "lane14" : false, "lane15" : false } } ], "event_confidence" : 100, "event_ex_info" : { "participants" : [ { "ptc_type" : "unknown", "plate_no" : "粤B1234567", "speed" : 110, "vehicle_class" : 54, "gat_vehicle_class" : "K33", "track_id" : 100, "lane_no" : 1, "start_time" : 1664507548437 } ], "congestion_info" : { "level" : 0, "length" : 200, "speed" : 10, "start_time" : 1664507548437, "start_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 }, "end_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 }, "congestion_lanes_info" : [ { "laneid" : 1, "level" : 0, "length" : 200, "speed" : 10, "start_time" : 1664507548437, "start_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 }, "end_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 } } ] }, "data_source" : { "radar" : [ 1 ], "camera" : [ 1 ] }, "camera_list" : [ { "id" : 0, "ip" : "127.0.0.1" } ] } } ] }}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XRSITopicBodyDTO object 参数说明：即时事件消息。来源于边缘感知计算单元分析生成的即时事件。 header 是 OpenRSITopicHeaderDTO object 参数说明：路侧交通消息的附加描述。 表2 OpenV2XRSITopicBodyDTO 参数 是否必选 参数类型 描述 rsi_source 否 RSISource object 参数说明：消息来源。 time_stamp 否 String 参数说明：采集数据的UTC时间。格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'，如2021-12-18T07:20:51.683Z。rsu上报的rsi不推送该字段。 最小长度：0 最大长度：63 rtss 否 Array of RTSData objects 参数说明：道路交通标志。 数组长度：1 - 16 rtes 否 Array of RTEData objects 参数说明：道路交通事件。 数组长度：1 - 8 表3 RSISource 参数 是否必选 参数类型 描述 rsi_source_type 是 String 参数说明：来源的具体类型描述。 取值范围： rsu：RSU上报数据 obu：车载终端上报数据 detection：检测器检测到的数据 v2xServer：平台上报数据 internet：互联网数据 meteorological：气象数据 government：政府数据 police：警方数据 unknown：未知数据 camera：摄像头 sne: sne上报 枚举值： rsu obu detection v2xServer internet meteorological government police unknown camera sne rsi_source_id 否 String 参数说明：信息来源的唯一标识码ID。 最小长度：1 最大长度：255 esn 是 String 参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 表4 RTSData 参数 是否必选 参数类型 描述 rts_id 是 Integer 参数说明：RTS的本地id。 最小值：0 最大值：255 sign_type 是 Integer 参数说明：道路交通标志类型，参考国标GB 5768.2-2009。 最小值：1 最大值：520 cross_id 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 sign_position 否 Position3D object 参数说明：位置信息。 sign_description 否 String 参数说明：道路交通标志的附加说明。 最小长度：0 最大长度：255 time_details 否 RSITimeDetails object 参数说明：定义道路交通事件和道路交通标志信息的生效时间属性。 sign_priority 否 Integer 参数说明：道路交通标志紧急程度。数字越大，级别越高。 最小值：0 最大值：7 reference_paths 否 Array of ReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 reference_links 否 Array of ReferenceLink objects 参数说明：道路交通事件的关联路段集合。 数组长度：1 - 16 表5 RTEData 参数 是否必选 参数类型 描述 event_id 否 String 参数说明：唯一的事件标识ID。 最小长度：0 最大长度：36 rte_id 是 Integer 参数说明：道路交通事件的本地id。 最小值：0 最大值：255 cross_id 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 event_type 是 Integer 参数说明：GB/T 29100-2012定义的事件类型。 最小值：0 最大值：65535 event_source 是 String 参数说明：来源的具体类型描述。 取值范围： rsu：RSU上报数据 obu：车载终端上报数据 detection：检测器检测到的数据 v2xServer：平台上报数据 internet：互联网数据 meteorological：气象数据 government：政府数据 police：警方数据 unknown：未知数据 camera：摄像头 -sne: sne上报 枚举值： rsu obu detection v2xServer internet meteorological government police unknown camera sne event_position 否 Position3D object 参数说明：位置信息。 event_radius 否 Integer 参数说明：事件半径，单位分米。 最小值：0 最大值：1000 event_description 否 String 参数说明：道路交通事件的描述信息。 最小长度：0 最大长度：255 time_details 否 RSITimeDetails object 参数说明：定义道路交通事件和道路交通标志信息的生效时间属性。 event_priority 否 Integer 参数说明：道路交通事件的紧急程度。数字越大，级别越高。 最小值：0 最大值：7 reference_paths 否 Array of ReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 reference_links 否 Array of ReferenceLink objects 参数说明：道路交通事件的关联路段集合。 数组长度：1 - 16 event_confidence 否 Integer 参数说明：道路交通事件的信息来源提供的事件置信度水平，帮助接收端判断是否相信该事件信息，单位为0.5%。 最小值：0 最大值：200 event_ex_info 否 EdgeEventExInfo object 参数说明：交通事件扩展信息。 表6 Position3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表7 RSITimeDetails 参数 是否必选 参数类型 描述 start_time 否 Integer 参数说明：数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 end_time 否 Integer 参数说明：数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 end_time_confidence 否 Integer 参数说明：数值描述了95%置信水平的结束时间置信度。该精度理论上只考虑了当前计时系统本身传感器的误差。参考 时间精度参数说明。 最小值：0 最大值：39 表8 ReferencePath 参数 是否必选 参数类型 描述 active_path 是 Array of Position3D objects 参数说明：与当前情况关联的有效点集。 数组长度：1 - 8 path_radius 否 Integer 参数说明：单位为0.1米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。 最小值：0 最大值：200 表9 ReferenceLink 参数 是否必选 参数类型 描述 up_stream_node_id 是 NodeReferenceID object 参数说明：节点ID是由一个全局唯一的地区ID和一个地区内部唯一的节点ID组成。 down_stream_node_id 是 NodeReferenceID object 参数说明：节点ID是由一个全局唯一的地区ID和一个地区内部唯一的节点ID组成。 reference_lane 否 ReferenceLanes object 参数说明：关联车道,将指定车道号对应的比特位置1表示该车道为有效的关联车道。最多支持15条车道。车道号，以该车道行驶方向为参考，自左向右从 1 开始编号。 表10 NodeReferenceID 参数 是否必选 参数类型 描述 region 是 Integer 参数说明：所在区域的编号,数值 0 仅用于测试。 最小值：0 最大值：65535 node_id 是 Integer 参数说明：节点编号，路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。数值 0~255 预留为测试使用。 最小值：0 最大值：65535 表11 ReferenceLanes 参数 是否必选 参数类型 描述 reserve0 否 Boolean 参数说明：保留参数。 缺省值：false lane1 否 Boolean 参数说明：左侧第1车道。 缺省值：false lane2 否 Boolean 参数说明：左侧第2车道。 缺省值：false lane3 否 Boolean 参数说明：左侧第3车道。 缺省值：false lane4 否 Boolean 参数说明：左侧第4车道。 缺省值：false lane5 否 Boolean 参数说明：左侧第5车道。 缺省值：false lane6 否 Boolean 参数说明：左侧第6车道。 缺省值：false lane7 否 Boolean 参数说明：左侧第7车道。 缺省值：false lane8 否 Boolean 参数说明：左侧第8车道。 缺省值：false lane9 否 Boolean 参数说明：左侧第9车道。 缺省值：false lane10 否 Boolean 参数说明：左侧第10车道。 缺省值：false lane11 否 Boolean 参数说明：左侧第11车道。 缺省值：false lane12 否 Boolean 参数说明：左侧第12车道。 缺省值：false lane13 否 Boolean 参数说明：左侧第13车道。 缺省值：false lane14 否 Boolean 参数说明：左侧第14车道。 缺省值：false lane15 否 Boolean 参数说明：左侧第15车道。 缺省值：false 表12 EdgeEventExInfo 参数 是否必选 参数类型 描述 camera_list 否 Array of EdgeCameraInfo objects 拍摄到事件的摄像头信息； 数组长度：0 - 10 participants 否 Array of EdgeEventParticipant objects 识别出交通事件时所对应的交通参与者 数组长度：0 - 20 congestion_info 否 EdgeCongestionInfo object 拥堵事件时，携带的信息 data_source 否 EdgeDataSourceInfo object 数据来源 表13 EdgeCameraInfo 参数 是否必选 参数类型 描述 id 否 Integer SNE的摄像头id,编号从0开始 最小值：0 最大值：128 ip 否 String 摄像头ip 最小长度：0 最大长度：15 表14 EdgeEventParticipant 参数 是否必选 参数类型 描述 ptc_type 否 String 交通参与者的具体类型描述，枚举 枚举值： unknown motor non-motor pedestrian plate_no 否 String 参数说明：车牌号 取值范围：长度不超过10，大写字母、数字、中文、阿拉伯文的组合。 speed 否 Integer 对应车辆被检测到超速或者慢行时的速度小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 vehicle_class 否 Integer 车辆类型，参考RSM中的车辆类型定义 最小值：0 最大值：255 track_id 否 Long 感知设备识别的id，具体表示为机动车轨迹ID 最小值：0 最大值：9223372036854775807 lane_no 否 Integer 参数说明: 车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。 最小值：-32 最大值：32 gat_vehicle_class 否 String 参数说明: 国标车辆类型，参考国标 target_rects 否 Array of TargetRect objects 参数说明：目标检测框信息列表。 数组长度：0 - 10 start_time 否 Long 参数说明: 本次事件中，车辆检测到事件行为的最初时间；格式：1970开始的毫秒时间。 最小值：0 最大值：9223372036854775807 表15 TargetRect 参数 是否必选 参数类型 描述 camera_code 否 String 参数说明：摄像头编码。 最小长度：0 最大长度：32 camera_ip 否 String 参数说明：摄像头IP地址。 最小长度：0 最大长度：32 target_pos 否 TargetPos object 参数说明：目标检测框万分比坐标。 time_stamp_diff 否 Long 参数说明：与SnapTime的时间差值：当前检测框所在相机的时间戳减去雷视拟合轨迹中的SnapTime的差值。 表16 TargetPos 参数 是否必选 参数类型 描述 left_top_x 否 Long 参数说明：目标区域框左上X坐标。 最小值：0 最大值：2147483647 left_top_y 否 Long 参数说明：目标区域框左上Y坐标。 最小值：0 最大值：2147483647 right_bottom_x 否 Long 参数说明：目标区域框右下X坐标。 最小值：0 最大值：2147483647 right_bottom_y 否 Long 参数说明：目标区域框右下Y坐标。 最小值：0 最大值：2147483647 表17 EdgeCongestionInfo 参数 是否必选 参数类型 描述 level 否 Integer 拥堵级别， 1：拥堵级别低，速度[25, 30) 单位：km/h， 2：拥堵级别中，速度[15，25) 单位：km/h， 3：拥堵级别高，速度[0, 15) 单位：km/h 最小值：0 最大值：3 length 否 Integer 拥堵长度，单位：m 最小值：0 最大值：1000 speed 否 Double 参数说明：拥堵路段平均车速，单位：km/h。 最小值：0 最大值：250 start_time 否 Long 参数说明：拥堵开始时间；格式：1970开始的毫秒时间 最小值：0 最大值：9223372036854775807 start_point 否 ReportedPosition3D object 拥堵的起点经纬度 end_point 否 ReportedPosition3D object 拥堵的终点经纬度 congestion_lanes_info 否 Array of CongestionLanesInfo objects 参数说明：车道拥堵信息。 数组长度：0 - 100 表18 CongestionLanesInfo 参数 是否必选 参数类型 描述 laneid 否 Integer 参数说明：车辆所处车道。对于桩号递增的道路方向，其车道号为正数。对于桩号递减的道路方向，其车道号为负数。按照行驶方向，从左到右，从1开始编号。 最小值：-32 最大值：32 level 否 Integer 参数说明：拥堵级别。 取值范围： 1：拥堵级别低，速度[25, 30) 单位：km/h 2：拥堵级别中，速度[15，25) 单位：km/h 3：拥堵级别高，速度[0, 15) 单位：km/h 最小值：0 最大值：3 length 否 Integer 参数说明：拥堵长度，单位为米（m）。 最小值：0 最大值：1000 speed 否 Double 参数说明：拥堵车道平均车速，单位：km/h。 最小值：0 最大值：250 start_time 否 Long 参数说明：拥堵开始时间；格式：1970开始的毫秒时间 最小值：0 最大值：9223372036854775807 start_point 否 ReportedPosition3D object 参数说明：拥堵的起点经纬度。 end_point 否 ReportedPosition3D object 参数说明：拥堵的终点经纬度。 表19 ReportedPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表20 EdgeDataSourceInfo 参数 是否必选 参数类型 描述 radar 否 Array of integers 雷达id 最小值：0 最大值：2147483647 数组长度：0 - 4 camera 否 Array of integers 摄像头id 最小值：0 最大值：2147483647 数组长度：0 - 4 表21 OpenRSITopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 event 是 String 参数说明：操作描述。" 取值范围： MODIFIED：修改 ADDED：新增 DELETED：删除 枚举值： MODIFIED ADDED DELETED

机动车车辆类型（gat_vehicle_class） 机动车车辆类型代码 含义 K10 大型客车 K11 大型普通客车 K12 大型双层客车 K13 大型卧铺客车 K14 大型铰接客车 K15 大型越野客车 K16 大型轿车 K17 大型专用客车 K20 中型客车 K21 中型普通客车 K22 中型双层客车 K23 中型卧铺客车 K24 中型铰接客车 K25 中型越野客车 K27 中型专用客车 K30 小型客车 K31 小型普通客车 K32 小型越野客车 K33 小型轿车 K34 小型专用客车 K40 微型客车 K41 微型普通客车 K42 微型越野客车 K43 微型轿车 H10 重型货车 H11 重型普通货车 H12 重型厢式货车 H13 重型封闭货车 H14 重型罐式货车 H15 重型平板货车 H16 重型集装厢车 H17 重型自卸货车 H18 重型特殊结构货车 H19 重型仓栅式货车 H20 中型货车 H21 中型普通货车 H22 中型厢式货车 H23 中型封闭货车 H24 中型罐式货车 H25 中型平板货车 H26 中型集装厢车 H27 中型自卸货车 H28 中型特殊结构货车 H29 中型仓栅式货车 H30 轻型货车 H31 轻型普通货车 H32 轻型厢式货车 H33 轻型封闭货车 H34 轻型罐式货车 H35 轻型平板货车 H37 轻型自卸货车 H38 轻型特殊结构货车 H39 轻型仓栅式货车 H40 微型货车 H41 微型普通货车 H42 微型厢式货车 H43 微型封闭货车 H44 微型罐式货车 H45 微型自卸货车 H46 微型特殊结构货车 H47 微型仓栅式货车 H50 低速货车 H51 普通低速货车 H52 厢式低速货车 H53 罐式低速货车 H54 自卸低速货车 H55 仓栅式低速货车 Q10 重型牵引车 Q11 重型半挂牵引车 Q12 重型全挂牵引车 Q20 中型牵引车 Q21 中型半挂牵引车 Q22 中型全挂牵引车 Q30 轻型牵引车 Q31 轻型半挂牵引车 Q32 轻型全挂牵引车 Z11 大型专项作业车 Z21 中型专项作业车 Z31 小型专项作业车 Z41 微型专项作业车 Z51 重型专项作业车 Z71 轻型专项作业车 D11 无轨电车 D12 有轨电车 M10 三轮摩托车 M11 普通正三轮摩托车 M12 轻便正三轮摩托车 M13 正三轮载客摩托车 M14 正三轮载货摩托车 M15 侧三轮摩托车 M20 二轮摩托车 M21 普通二轮摩托车 M22 轻便二轮摩托车 N11 三轮汽车 T11 大型轮式拖拉机 T20 小型拖拉机 T21 小型轮式拖拉机 T22 手扶拖拉机 T23 手扶变形运输机 J11 轮式装载机械 J12 轮式挖掘机械 J13 轮式平底机械 G10 重型全挂车 G11 重型普通全挂车 G12 重型厢式全挂车 G13 重型罐式全挂车 G14 重型平板全挂车 G15 重型集装箱全挂车 G16 重型自卸全挂车 G17 重型仓栅式全挂车 G18 重型旅居全挂车 G19 重型专项作业全挂车 G20 中型全挂车 G21 中型普通全挂车 G22 中型厢式全挂车 G23 中型罐式全挂车 G24 中型平板全挂车 G25 中型集装箱全挂车 G26 中型自卸全挂车 G27 中型仓栅式全挂车 G28 中型旅居全挂车 G29 中型专项作业全挂车 G30 轻型全挂车 G31 轻型普通全挂车 G32 轻型厢式全挂车 G33 轻型罐式全挂车 G34 轻型平板全挂车 G35 轻型自卸全挂车 G36 轻型仓栅式全挂车 G37 轻型旅居全挂车 G38 轻型专项作业全挂车 B10 重型半挂车 B11 重型普通半挂车 B12 重型厢式半挂车 B13 重型罐式半挂车 B14 重型平板半挂车 B15 重型集装箱半挂车 B16 重型自卸半挂车 B17 重型特殊结构半挂车 B18 重型仓栅式半挂车 B19 重型旅居半挂车 B1A 重型专项作业半挂车 B1B 重型低平板半挂车 B20 中型半挂车 B21 中型普通半挂车 B22 中型厢式半挂车 B23 中型罐式半挂车 B24 中型平板半挂车 B25 中型集装箱半挂车 B26 中型自卸半挂车 B27 中型特殊结构半挂车 B28 中型仓栅式半挂车 B29 中型旅居半挂车 B2A 中型专项作业半挂车 B2B 中型低平板半挂车 B30 轻型半挂车 B31 轻型普通半挂车 B32 轻型厢式半挂车 B33 轻型罐式半挂车 B34 轻型平板半挂车 B35 轻型自卸半挂车 B36 轻型仓栅式半挂车 B37 轻型旅居半挂车 B38 轻型专项作业半挂车 B39 轻型低平板半挂车 X99 其他 机动车车辆类型定义参考GA/T 16.4-2012 《道路交通管理信息代码第4部分：机动车车辆类型代码》标准要求。 父主题： 参数说明列表

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：总数 radars Array of RadarResourceDTO objects 参数说明：数据列表 表5 RadarResourceDTO 参数 参数类型 描述 radar_id String 参数说明：雷达ID 取值范围：长度不小于1，不大于64的英文字母、数字和下划线（_）的组合。 name String 参数说明：名称 取值范围：长度不小于1，不大于128的汉字、英文字母、数字、下划线（_）和横杠（-）的组合。 v2x_edge_id String 参数说明：所属的EdgeId 取值范围：长度不小于1，不大于128的英文字母、数字、下划线（_）和横杠（-）的组合。 ip String 参数说明：设备IP status String 参数说明：状态值 取值范围： ONLINE：在线 OFFLINE：离线 UNKNOWN：未知 SLEEP：睡眠 esn String 参数说明：设备编号 取值范围：长度不小于1，不大于64的英文字母、数字和下划线（_）的组合。 position_description String 参数说明：位置描述 取值范围：长度不小于1，不大于128的英文字母、数字和下划线（_）的组合。 sequence_no Integer 参数说明：雷达序号，该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 direction Integer 参数说明：道路检测方向，0表示朝向起点，1表示朝向终点,255表示无效值。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 lon Number 参数说明：雷达设备的经度，东经为正，西经为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 lat Number 参数说明：雷达设备的纬度，北纬为正，南纬为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 sensor_angle Number 参数说明：感知设备部署的角度，以正北为0，顺时针旋转（无线的部署方式）。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 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 last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

响应示例 状态码： 200 ok { "count" : 1, "radars" : [ { "radar_id" : "28f61af50fc9452aa0ed5ea25c3cc3d3", "name" : "radar00001", "v2x_edge_id" : "28f61af50fc9452aa0ed5ea25c3cc3d3", "ip" : "127.0.0.1", "status" : "ONLINE", "esn" : "abcd00001", "position_description" : "k01", "sequence_no" : 1, "direction" : 0, "lon" : 114.0398513, "lat" : 30.5087712, "sensor_angle" : 124.711914, "created_time" : "2020-09-01T01:37:01Z", "last_modified_time" : "2020-09-01T01:37:01Z", "last_online_time" : "2020-09-01T01:37:01Z" } ]}

Message示例 { "vehicle_id" : "test_v_001", "time_stamp" : "2021-01-08T02:03:41.907Z", "speed" : 3000, "heading" : 10000, "transmission" : 2, "pos" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "brakes" : { "abs" : 1, "scs" : 1, "brake_boost" : 1, "aux_brakes" : 1, "brake_pedal" : 1, "traction" : 1, "wheel_brakes" : [ 1, 0, 0, 1, 1 ] }, "vehicle_class" : { "classification" : 54, "fuel_type" : 5 }, "accel_set" : { "long" : 0, "lat" : 0, "vert" : 0, "yaw" : 0 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 }, "motion_cfd" : { "speed_cfd" : 5, "heading_cfd" : 5 }, "pos_confidence" : 10}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：返回信号机设备的总体数量。 traffic_controller_devices Array of TrafficControllerDTO objects 参数说明：数据列表。 表5 TrafficControllerDTO 参数 参数类型 描述 traffic_controller_id String 参数说明：信号机设备ID，全局唯一。 esn String 参数说明：序列号。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 name String 参数说明：名称。 description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 ele Number 参数说明：定义海拔高程，可选，单位为分米。 pos_description String 参数说明：位置说明。 取值范围：长度不超过128，只允许字母、数字、以及_等字符的组合。 installation_mode String 参数说明：架设方式。 取值范围： columnar：柱式 road-side-attach：路侧附着式 cantilever：悬臂式 gantry：门架式 lane-above-attach：车行道上方附着式 road_name String 参数说明：所属道路名称，比如高速名称。 取值范围：长度不超过64，只允许汉字、字母、数字、以及_-等字符的组合。 link_id String 参数说明：信号机设备所属路段ID。 取值范围：长度等于30，只允许大写字母、数字。 status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

请求示例 GET https://{endpoint}/v1/{project_id}/traffic-controllers?limit={limit}&offset={offset}&status={status}&esn={esn}&traffic_controller_id={traffic_controller_id}Content-Type:application/jsonX-Auth-Token:********Instance-Id:********"

响应示例 状态码： 200 OK { "count" : 1, "traffic_controller_devices" : [ { "traffic_controller_id" : "13229397084005974033576909202199", "esn" : "17598448011929637214623971962555", "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road1", "link_id" : "12345676", "status" : "INITIAL", "last_modified_time" : "2022-01-06T09:30:24Z", "created_time" : "2022-01-06T09:30:24Z", "last_online_time" : null } ]}

响应示例 状态码： 200 OK { "v2x_edge_id" : "ab6cb4ca-bc7a-4b3d-8629-7212c5d9a6b0", "name" : "name", "description" : "test", "esn" : "ESN01234567", "ip" : "127.0.0.1", "port" : "8880", "hardware_type" : "ATLAS", "server_protocol_type" : "http", "server_cert" : null, "position_description" : "testtest", "location" : { "lat" : 22.4, "lon" : 124 }, "cameras" : [ "ab6cb4ca-bc7a-4b3d-8629-7212c5d9a6b0" ], "radars" : [ "ab6cb4ca-bc7a-4b3d-8629-7212c5d9a6b0" ], "local_rsus" : [ "rsu_test_01" ], "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" : false, "road_detection_length" : 10, "ramp_detection_length" : 10, "edge_authentications" : [ { "user_name" : "dris_user" } ], "gat1400_username" : null, "user_name" : "dris_user" }, "edge_advance_config" : { "testKey" : "testValue" }, "status" : "ONLINE", "node_id" : "536434354358674544874543587", "created_time" : "2020-09-01T01:37:01Z", "last_modified_time" : "2020-09-01T01:37:01Z"}

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

错误码说明 当您调用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解析失败 请联系华为工程师分析解决。

Message示例 { "name": "testrsm", "content": "{\"rsm_source\":{\"rsm_source_type\":\"rsu\",\"rsm_source_id\":\"RSU0123456789\",\"esn\":\"2102312ETX10K7000037\"},\"id\":\"12345678\",\"time_stamp\":1626488844123,\"send_time\":1626488844123,\"ref_pos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"participants\":[{\"ptc_type\":\"unknown\",\"ptc_id\":3,\"global_track_id\":3,\"source\":\"rsu\",\"id\":\"12345678\",\"sec_mark\":0,\"pos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"pos_confidence\":{\"position_confidence\":10,\"ele_confidence\":10},\"transmission\":2,\"speed\":3000,\"heading\":10000,\"angle\":0,\"vehicle_color\":\"black\",\"vehicle_model\":\"朗逸\",\"vehicle_brand\":\"230\",\"vehicle_style\":\"2018,2019,2020\",\"gat_vehicle_class\":\"K33\",\"cross_id\":\"cross0123456789\",\"lane_no\":1,\"plate_no\":\"粤B12345\",\"motion_cfd\":{\"speed_confidence\":5,\"heading_confidence\":5,\"steer_confidence\":5},\"accel_set\":{\"long_accel\":0,\"lat_accel\":0,\"vert_accel\":0,\"yaw_rate\":0},\"size\":{\"width\":200,\"length\":3000,\"height\":40},\"vehicle_class\":{\"basic_vehicle_class\":54,\"fuel_type\":5}}]}"}

Message参数 表1 求Body参数 参数 是否必选 参数类型 描述 name 否 String 参数说明：消息名称。 取值范围：长度不超过128，只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。 content 是 表2 ObuRsmDto object 参数说明：下发RSM消息内容，该参数值为JSON字符串。 表2 ObuRsmDto 参数 是否必选 参数类型 描述 rsm_source 否 表3 RsmSource object 消息来源 id 是 String 检测设备的唯一标识id time_stamp 否 Long 采集数据的毫秒时间戳。例如：1639812051683，转换后代表北京时间"2021-12-18 15:20:51"。 send_time 否 Long 数据融合后的发送时间，毫秒时间戳。例如：1639812051683，转换后代表北京时间"2021-12-18 15:20:51"。 ref_pos 是 表5 ObuReceivedRsmPosition3D object 参数说明：位置信息。 participants 是 Array of 表4 ObuReceivedRsmParticipantData objects 交通参与者列表。应用于RSM消息，表示当前探测到的所有或者部分交通参与者信息。 表3 RsmSource 参数 是否必选 参数类型 描述 rsm_source_type 是 String 参数说明：RSM消息来源。 取值范围： unknown：未知 rsu：rsu设备上报 obu：车辆上报 detection：V2XEdge上报 sne：无线SNE上报 camera：摄像头上报 rsm_source_id 否 String 信息来源的唯一标识码ID。 esn 是 String 参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 表4 ObuReceivedRsmParticipantData 参数 是否必选 参数类型 描述 ptc_type 是 String 参数说明：路侧单元检测到的交通参与者类型。 取值范围： unknown：未知 motor：机动车 non-motor：非机动车 pedestrian：行人 rsu：rsu设备 ptc_id 是 Integer 检测单元设置的临时ID global_track_id 否 Long ITS800通过GlobalTrackID字段标识了车辆唯一ID source 否 String 参数说明：交通参与者数据的来源。 取值范围： unknown：未知 rsu：rsu设备上报 obu：车辆上报 detection：V2XEdge上报 sne：无线SNE上报 camera：摄像头上报 id 否 String 对应BSM里的车辆ID，一般不携带。 sec_mark 是 Integer 以0.1 秒为单位，定义1分钟中的毫秒级时刻。分辨率为1毫秒，有效范围是0~59999。 60000及以上表示未知或无效数值。 pos 是 表5 ObuReceivedRsmPosition3D object 参数说明：位置信息。 pos_confidence 是 表6 ObuReceivedRsmPositionalConfidence object 定义当前实时位置（经纬度和高程）的精度大小，包括水平位置精度和高程精度，由系统自身进行实时计算和更新 transmission 否 Integer 车辆档位状态。0：空档；1：停止档；2：前进档；3：倒档；7：不可用。4~6预留。 speed 是 Integer 车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 heading 是 Integer 车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 angle 否 Integer 定义车辆转向轮角度。向右为正，向左为负。单位为1.5°。值为127时代表无效值。 vehicle_color 否 String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 vehicle_model 否 String 参数说明: 车辆型号 取值范围：允许字母、数字、中文的组合。 vehicle_brand 否 String 车辆品牌,ITS800中取值为0-230 vehicle_style 否 String 车辆年款，通过年份来表示，多个年份通过逗号分隔 gat_vehicle_class 否 String 机动车车辆类型。参考机动车车辆类型。 cross_id 否 String 路口ID，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 lane_no 否 Integer 参数说明: 车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。 plate_no 否 String 车牌号，可选字段。取值范围：大写字母、数字、中文、阿拉伯文的组合。 motion_cfd 否 表7 ObuReceivedRsmMotionConfidenceSet object 描述车辆运行状态的精度。包括车速精度、航向精度和方向盘转角的精度。 accel_set 否 表8 ObuReceivedRsmAccelerationSet4Wayobject 定义车辆四轴加速度 size 是 表9 ObuReceivedRsmVehicleSize object 参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 vehicle_class 否 表10 ObuReceivedRsmVehicleClassificationobject 定义车辆类型。包含车辆基本类型以及燃料动力类型 表5 ObuReceivedRsmPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 ele 否 Object 参数说明：定义海拔高程，可选，单位为分米。数值-4096 表示无效数值。 表6 ObuReceivedRsmPositionalConfidence 参数 是否必选 参数类型 描述 position_confidence 是 Integer 数值描述了95%置信水平的车辆位置精度。值为0时代表不可用。 ele_confidence 否 Integer 数值描述了95%置信水平的车辆高程精度。值为0时代表不可用 表7 ObuReceivedRsmMotionConfidenceSet 参数 是否必选 参数类型 描述 speed_confidence 否 Integer 数值描述了95% 置信水平的速度精度。值为0时代表不可用 heading_confidence 否 Integer 数值描述了95% 置信水平的航向精度。值为0时代表不可用 steer_confidence 否 Integer 数值描述了95% 置信水平的车辆转向轮角度精度。0代表不可用；1代表2°；2代表1°；3代表0.02° 表8 ObuReceivedRsmAccelerationSet4Way 参数 是否必选 参数类型 描述 long_accel 是 Integer 车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值 lat_accel 是 Integer 车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值 vert_accel 是 Integer 定义Z轴方向的加速度大小，Z轴方向竖直向下，沿着Z轴方向为正。分辨率为0.02G，G 为重力加速度值 9.80665m/s2 yaw_rate 是 Integer 车辆横摆角速度。指汽车绕垂直轴的偏转，该偏转的大小代表汽车的稳定程度。如果偏转角速度达到一个阈值，说明汽车发生测滑或者甩尾等危险工况。顺时针旋转为正，逆时针为负。数据分辨率为 0.01°/s 表9 ObuReceivedRsmVehicleSize 参数 是否必选 参数类型 描述 width 否 Integer 参数说明：车辆车身宽度。单位为0.01米。值为0时代表无效数值。 length 否 Integer 参数说明：车辆车身长度。单位为0.01米。值为0时代表无效数值。 height 否 Integer 参数说明：车辆车身高度。单位为0.05米。值为0时代表无效数值。 表10 ObuReceivedRsmVehicleClassification 参数 是否必选 参数类型 描述 basic_vehicle_class 是 Integer 定义车辆基本类型。 fuel_type 否 Integer 定义车辆的燃料动力类型,0未知，1汽油，2乙醇，3柴油，4电动，5混合燃料类型，6氢气，7液化天然气，8压缩天然气，9丙烷

设置对象转换策略 以下代码展示了如何设置最新版本对象和历史版本对象的转换策略： static OBSClient *client; NSString *endPoint = @"your-endpoint"; // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env]; // 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; // 设置一条规则OBSLifecycleRule *rule = [[OBSLifecycleRule alloc] initWithID:@"delete-2-days" prefix:@"test/" status:OBSLifecycleStatusEnabled];// 创建30天后转换成低频访问存储OBSLifecycleTransition* transitionStandard = [[OBSLifecycleTransition alloc]initWithDays:[NSNumber numberWithInteger:30] storageClass:OBSStorageClassStandardIA];// 创建60天后转换成指定存储OBSLifecycleTransition* transitionGlacier= [[OBSLifecycleTransition alloc]initWithDays:[NSNumber numberWithInteger:60] storageClass:OBSStorageClassGlacier];// 30天后历史版本转换成标准存储OBSLifecycleNoncurrentVersionTransition* noncurrentTransistionStandard = [[OBSLifecycleNoncurrentVersionTransition alloc]initWithDays:[NSNumber numberWithInteger:30] storageClass:OBSStorageClassStandardIA];//60天后历史版本转换成归档存储OBSLifecycleNoncurrentVersionTransition* noncurrentTransistionGlacier= [[OBSLifecycleNoncurrentVersionTransition alloc]initWithDays:[NSNumber numberWithInteger:60] storageClass:OBSStorageClassGlacier]; [rule.transitionList addObject:transitionStandard];[rule.transitionList addObject:transitionGlacier]; [rule.noncurrentVersionTransitionList addObject:noncurrentTransistionStandard];[rule.noncurrentVersionTransitionList addObject:noncurrentTransistionGlacier]; rule.expiration = expiration;rule.noncurrentVersionExpiration = noncurrentExpiration; OBSSetBucketLifecycleRequest *request = [[OBSSetBucketLifecycleRequest alloc]initWithBucketName:@"bucketname" ];[request.lifecycleRuleList addObject: rule];OBSLifecycleRule* rule2 = [rule copy];rule2.ID = @"123";rule2.prefix = @"test1/";[request.lifecycleRuleList addObject: rule2]; [client setBucketLifecycle:request completionHandler:^(OBSSetBucketLifecycleResponse *response, NSError *error){ NSLog(@"%@",response); }];

设置桶标签 您可以通过setBucketTagging设置桶标签。以下代码展示了如何设置桶标签： static OBSClient *client;NSString *endPoint = @"your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env]; // 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; // 设置桶标签OBSSetBucketTaggingRequest *request = [[OBSSetBucketTaggingRequest alloc]initWithBucketName:@"bucketname"];[request.tagList addObject:[[OBSBucketTag alloc]initWithKey:@"tagkey" value:@"tagvalue"]];[request.tagList addObject:[[OBSBucketTag alloc]initWithKey:@"tagkey1" value:@"tagvalue1"]]; [client setBucketTagging:request completionHandler:^(OBSSetBucketTaggingResponse *response, NSError *error){ NSLog(@"%@",response); }]; 每个桶支持最多10个标签。 标签的key和value支持unicode。 父主题： 标签管理

OBS服务端错误码 在向OBS服务端发出请求后，如果遇到错误，会在响应中包含响应的错误码描述错误信息。详细的错误码及其对应的描述和HTTP状态码见下表： 错误码 描述 HTTP状态码 AccessDenied 拒绝访问。 403 Forbidden AccessForbidden 权限不足。 403 Forbidden AccountProblem 用户的账号出现异常（过期、冻结等），不能成功地完成操作。 403 Forbidden AllAccessDisabled 用户无权限执行某操作。 403 Forbidden AmbiguousGrantByEmailAddress 用户提供的Email地址关联的账号超过了1个。 400 Bad Request BadDigest 客户端指定的对象内容的MD5值与系统接收到的内容MD5值不一致。 400 Bad Request BadDomainName 域名 不合法。 400 Bad Request| BadRequest 请求参数不合法。 400 Bad Request BucketAlreadyExists 请求的桶名已经存在。桶的命名空间是系统中所有用户共用的，选择一个不同的桶名再重试一次。 409 Conflict BucketAlreadyOwnedByYou 发起该请求的用户已经创建过了这个名字的桶，并拥有这个桶。 409 Conflict BucketNotEmpty 用户尝试删除的桶不为空。 409 Conflict CredentialsNotSupported 该请求不支持证书验证。 400 Bad Request CustomDomainAreadyExist 配置了已存在的域。 400 Bad Request CustomDomainNotExist 操作的域不存在。 400 Bad Request DeregisterUserId 用户已经注销。 403 Forbidden EntityTooSmall 用户试图上传的对象大小小于系统允许的最小大小。 400 Bad Request EntityTooLarge 用户试图上传的对象大小超过了系统允许的最大大小。 400 Bad Request FrozenUserId 用户被冻结。 403 Forbidden IllegalVersioningConfiguration Exception 请求中的版本配置无效。 400 Bad Request IllegalLocationConstraintException 配置了与所在Region不匹配的区域限制。 400 Bad Request InArrearOrInsufficientBalance 因为ACL而没有权限进行某种操作。 403 Forbidden IncompleteBody 请求体不完整。 400 Bad Request IncorrectNumberOfFilesInPost Request 每个POST请求都需要带一个上传的文件。 400 Bad Request InlineDataTooLarge Inline Data超过了允许的最大长度。 400 Bad Request nsufficientStorageSpace 存储空间不足。 403 Forbidden InternalError 系统遇到内部错误，请重试。 500 Internal Server Error InvalidAccessKeyId 系统记录中不存在客户提供的Access Key Id。 403 Forbidden InvalidAddressingHeader 用户必须指定匿名角色 N/A InvalidArgument 无效的参数。 400 Bad Request InvalidBucketName 请求中指定的桶名无效。 400 Bad Request InvalidBucket 请求访问的桶已不存在。 400 Bad Request InvalidBucketState 无效的桶状态。 409 Conflict InvalidBucketStoragePolicy 修改桶策略时，提供的新策略不合法。 400 Bad Request InvalidDigest HTTP头中指定的Content-MD5值无效。 400 Bad Request InvalidEncryptionAlgorithmError 错误的加密算法。 400 Bad Request InvalidLocationConstraint 创建桶时，指定的location不合法。 400 Bad Request InvalidPart 一个或多个指定的段无法找到。这些段可能没有上传，或者指定的entity tag与段的entity tag不一致。 400 Bad Request InvalidPartOrder 段列表的顺序不是升序，段列表必须按段号升序排列。 400 Bad Request InvalidPayer 所有对这个对象的访问已经无效了。 403 Forbidden InvalidPolicyDocument 表单中的内容与策略文档中指定的条件不一致。 400 Bad Request InvalidRange 请求的range不可获得。 416 Client Requested Range Not Satisfiable InvalidRedirectLocation 无效的重定向地址。 400 Bad Request InvalidRequest 无效请求。 400 Bad Request InvalidRequestBody POST请求体无效。 400 Bad Request InvalidSecurity 提供的安全证书无效。 403 Forbidden InvalidStorageClass 用户指定的Storage Class无效。 400 Bad Request InvalidTargetBucketForLogging delivery group对目标桶无ACL权限。 400 Bad Request InvalidURI 无法解析指定的URI。 400 Bad Request KeyTooLong 提供的Key过长。 400 Bad Request MalformedACLError 提供的XML格式错误，或者不符合要求的格式。 400 Bad Request MalformedError 请求中携带的XML格式不正确。 400 Bad Request MalformedLoggingStatus Logging的XML格式不正确。 400 Bad Request MalformedPolicy Bucket policy检查不通过。 400 Bad Request MalformedPOSTRequest POST请求的请求体不是结构化良好的多段或形式化数据。 400 Bad Request MalformedXML 当用户发送了一个配置项的错误格式的XML会出现这样的错误。错误消息是：“The XML you provided was not well-formed or did not validate against our published schema."。 400 Bad Request MaxMessageLengthExceeded 请求消息过长。 400 Bad Request MaxPostPreDataLengthExceeded Error 在上传文件前面的POST请求域过大。 400 Bad Request MetadataTooLarge 元数据消息头超过了允许的最大元数据大小。 400 Bad Request MethodNotAllowed 指定的方法不允许操作在请求的资源上。 对应返回的Message为：Specified method is not supported. 405 Method Not Allowed MissingContentLength 必须要提供HTTP消息头中的Content-Length字段。 411 Length Required MissingRegion 请求中缺少Region信息，且系统无默认Region。 400 Bad Request MissingRequestBodyError 当用户发送一个空的XML文档作为请求时会发生。错误消息是：“Request body is empty.”。 400 Bad Request MissingRequiredHeader 请求中缺少必要的头域。 400 Bad Request MissingSecurityHeader 请求缺少一个必须的头。 400 Bad Request NoSuchBucket 指定的桶不存在。 404 Not Found NoSuchBucketPolicy 桶policy不存在。 404 Not Found NoSuchCORSConfiguration CORS配置不存在。 Not Found NoSuchCustomDomain 请求的用户域不存在。 404 Not Found NoSuchKey 指定的Key不存在。 404 Not Found NoSuchLifecycleConfiguration 请求的LifeCycle不存在。 404 Not Found NoSuchPolicy 给定的policy名字不存在。 404 Not Found NoSuchUpload 指定的多段上传不存在。Upload ID不存在，或者多段上传已经终止或完成。 404 Not Found NoSuchVersion 请求中指定的version ID与现存的所有版本都不匹配。 404 Not Found NoSuchWebsiteConfiguration 请求的Website不存在。 404 Not Found NotImplemented 用户提供的消息头功能上还没有实现。 501 Not Implemented NotSignedUp 账号未在系统中注册，必须先在系统中注册了才能使用该账号。 403 Forbidden OperationAborted 另外一个冲突的操作当前正作用在这个资源上，请重试。 409 Conflict PermanentRedirect 尝试访问的桶必须使用指定的节点，请将以后的请求发送到这个节点。 301 Moved Permanently PreconditionFailed 用户指定的先决条件中至少有一项没有包含。 412 Precondition Failed Redirect 临时重定向。 307 Moved Temporarily RequestIsNotMultiPartContent 桶POST必须是闭式的多段/表单数据。 400 Bad Request RequestTimeTooSkewed 请求的时间与服务器的时间相差太大。 403 Forbidden RequestTorrentOfBucketError 不允许请求桶的torrent文件。 400 Bad Request ServiceNotImplemented 请求的方法服务端没有实现。 501 Not Implemented ServiceNotSupported 请求的方法服务端不支持。 409 Conflict ServiceUnavailable 服务器过载或者内部错误异常。 503 Service Unavailable SignatureDoesNotMatch 请求中带的签名与系统计算得到的签名不一致。检查您的访问密钥（AK和SK）和签名计算方法。 403 Forbidden SlowDown 请降低请求频率。 503 Service Unavailable System Capacity Not enough 系统空间不足异常。 403 Forbidden TooManyCustomDomains 配置了过多的用户域。 400 Bad Request TemporaryRedirect 当DNS更新时，请求将被重定向到桶。 307 Moved Temporarily TooManyBuckets 用户拥有的桶的数量达到了系统的上限，并且请求试图创建一个新桶。 400 Bad Request TooManyObjectCopied 用户单个对象被拷贝的数量超过系统上限。 400 Bad Request TooManyWrongSignature 因高频错误请求被拒绝服务。 400 Bad Request UnexpectedContent 该请求不支持带内容字段。 400 Bad Request UnresolvableGrantByEmailAddress 用户提供的Email与记录中任何账号的都不匹配。 400 Bad Request UserKeyMustBeSpecified 请求中缺少用户的AK信息。 400 Bad Request WebsiteRedirect Website请求缺少bucketName。 301 Moved Permanently KMS.DisabledException SSE-KMS加密方式下，主密钥被禁用。 400 Bad Request KMS.NotFoundException SSE-KMS加密方式下，主密钥不存在。 400 Bad Request RestoreAlreadyInProgress 对象正在恢复，请求冲突。 409 Conflict ObjectHasAlreadyRestored 已经恢复的对象，禁止缩短恢复保存时间。 409 Conflict InvalidObjectState 恢复对象不是归档存储对象。 403 Forbidden InvalidTagError 配置桶标签时，提供了无效的Tag。 400 Bad Request NoSuchTagSet 指定的桶没有设置标签。 404 Not Found 父主题： 异常处理

生命周期管理简介 OBS允许您对桶设置生命周期规则，实现自动转换对象的存储类型、自动淘汰过期的对象，以有效利用存储特性，优化存储空间。针对不同前缀的对象，您可以同时设置多条规则。一条规则包含： 规则ID，用于标识一条规则，不能重复。 受影响的对象前缀，此规则只作用于符合前缀的对象。 最新版本对象的转换策略，指定方式为： 指定满足前缀的对象创建后第几天时转换为指定的存储类型。 直接指定满足前缀的对象转换为指定的存储类型的日期。 最新版本对象过期时间，指定方式为： 指定满足前缀的对象创建后第几天时过期。 直接指定满足前缀的对象过期日期。 历史版本对象转换策略，指定方式为： 指定满足前缀的对象成为历史版本后第几天时转换为指定的存储类型。 历史版本对象过期时间，指定方式为： 指定满足前缀的对象成为历史版本后第几天时过期。 是否生效标识。 更多关于生命周期的内容请参考生命周期管理。 对象过期后会被OBS服务端自动删除。 对象转换策略中的时间必须早于对象过期时间；历史版本对象转换策略中的时间也必须早于历史版本对象的过期时间。 桶必须开启多版本状态，历史版本对象转换策略和历史版本对象过期时间配置才能生效。 父主题： 生命周期管理

如何获取临时AK/SK 临时AK/SK和SecurityToken是系统颁发给用户的临时访问令牌，通过接口设置有效期，范围为15分钟至24小时，过期后需要重新获取。临时AK/SK和SecurityToken遵循权限最小化原则。使用临时AK/SK鉴权时，临时AK/SK和SecurityToken必须同时使用。 获取临时访问密钥的接口请参考获取临时AK/SK和securitytoken。 使用临时访问密钥的方法请参考临时访问密钥创建OBS客户端代码。 父主题： 常见问题

加密说明 OBS iOS SDK支持服务端加密的接口见下表： OBS iOS SDK接口方法 描述 支持加密类型 putObject 上传对象时设置加密算法、密钥，对对象启用服务端加密。 SSE-KMS SSE-C getObject 下载对象时设置解密算法、密钥，用于解密对象。 SSE-C copyObject 复制对象时设置源对象的解密算法、密钥，用于解密源对象。 复制对象时设置目标对象的加密算法、密钥，对目标对象启用加密算法。 SSE-KMS SSE-C getObjectMetadata 获取对象元数据时设置解密算法、密钥，用于解密对象。 SSE-C initiateMultipartUpload 初始化分段上传任务时设置加密算法、密钥，对分段上传任务最终生成的对象启用服务端加密。 SSE-KMS SSE-C uploadPart 上传段时设置加密算法、密钥，对分段数据启用服务端加密。 SSE-C copyPart 复制段时设置源对象的解密算法、密钥，用于解密源对象。 复制段时设置目标段的加密算法、密钥，对目标段启用加密算法。 SSE-C 父主题： 服务端加密

设置桶多版本状态 您可以通过setBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态： 多版本状态 说明 OBS iOS SDK对应值 启用状态 上传对象时，系统为每一个对象创建一个唯一版本号，上传同名的对象将不再覆盖旧的对象，而是创建新的不同版本号的同名对象。 可以指定版本号下载对象，不指定版本号默认下载最新对象。 删除对象时可以指定版本号删除，不带版本号删除对象仅产生一个带唯一版本号的删除标记，并不删除对象。 列出桶内对象列表（OBSListObjectsRequest）时默认列出最新对象列表，可以指定列出桶内所有版本对象列表（OBSListObjectsVersionsRequest）。 除了删除标记外，每个版本的对象存储均需计费 OBSVersioningStatusEnabled 暂停状态 旧的版本数据继续保留。 上传对象时创建对象的版本号为null，上传同名的对象将覆盖原有同名的版本号为null的对象。 可以指定版本号下载对象，不指定版本号默认下载最新对象。 删除对象时可以指定版本号删除，不带版本号删除对象将产生一个版本号为null的删除标记，并删除版本号为null的对象。 除了删除标记外，每个版本的对象存储均需计费。 OBSVersioningStatusSuspended 以下代码展示了如何设置桶的多版本状态： static OBSClient *client;NSString *endPoint = @"your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env]; // 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; // 配置桶多版本OBSBucketVersioningConfiguration *conf1 = [OBSBucketVersioningConfiguration new]; conf1.status = OBSVersioningStatusEnabled;// 设置桶多版本OBSSetBucketVersioningRequest *request = [[OBSSetBucketVersioningRequest alloc] initWithBucketName:@"bucketname" configuration: conf];[client setBucketVersioning:request completionHandler:^(OBSSetBucketVersioningResponse *response, NSError *error) { NSLog(@"%@",response);}]; 父主题： 多版本控制