云服务器内容精选

  • Topic定义 设备使用MQTT协议接入平台时,平台和设备通过Topic进行通信。 上行Topic:设备上报消息到平台。 下行Topic:设备接收平台下发的消息。 平台支持的topic列表如下: Topic Publisher(发布者) Subscriber(订阅者) 用途 v2x/v1/rsu/{esn}/bsm/up 设备 平台 RSU上报BSM消息 v2x/v1/rsu/{esn}/map/up 设备 平台 RSU上报MAP消息 v2x/v1/rsu/{esn}/rsi/up 设备 平台 RSU上报RSI消息 v2x/v1/rsu/{esn}/rsm/up 设备 平台 RSU上报RSM消息 v2x/v1/rsu/{esn}/spat/up 设备 平台 RSU上报SPAT消息 oc/devices/{vehicle_id}/user/obu/bsm/up 设备 平台 OBU上报BSM v2x/v1/signalcontroller/{traffic_controller_id}/spat/up 设备 平台 信号机上报SPAT v2x/v1/rsu/{esn}/rsi/down 平台 设备 RSU接收RSI消息 v2x/v1/rsu/{esn}/spat/down 平台 设备 RSU接收SPAT消息 $oc/devices/{vehicle_id}/sys/messages/down 平台 设备 OBU接收RSI 父主题: 设备侧MQTT接口参考
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 platform_type String 参数说明:平台类型。 取值范围: DRIS:华为路网数字化平台 LITONG:利通 ZHONGQIYAN:中汽研 platform_para PlatformPara object 参数说明:platform_type为非DRIS时有效,表示第三方平台的对接参数 channel_status String 参数说明:华为路网数字化平台或第三方业务平台连接状态。 取值范围: ONLINE:在线 OFFLINE:离线 INITIAL:初始化 表4 PlatformPara 参数 参数类型 描述 address String 参数说明:第三方业务平台的ip地址和端口。 username String 参数说明:鉴权用户名。 取值范围:长度不超过255,只允许字母、数字、下划线(_)、问号(?)、反引号(')、井号(#)、左小括号(()、右小括号())、点(.)、逗号(,)、与(&)、百分号(%)、At(@)、感叹号(!)、连接符(-)的组合。 passwd String 参数说明:鉴权密码,ITS800或者ATLAS500的密码 取值范围:长度不超过255,只允许字母、数字、下划线(_)、问号(?)、反引号(')、井号(#)、左小括号(()、右小括号())、点(.)、逗号(,)、与(&)、百分号(%)、At(@)、感叹号(!)、连接符(-)的组合。
  • 响应示例 状态码: 200 OK { "edge_app_id" : "12617852507412065303014562034843", "version" : "1.0.2", "description" : "hello", "created_time" : "2020-05-28T11:31:29.740Z", "last_modified_time" : "2020-05-28T11:31:29.740Z", "state" : "DRAFT", "command" : null, "args" : null, "container_settings" : null, "publish_time" : null, "off_shelf_time" : "2020-05-28T11:31:29.740Z"}
  • 请求示例 PUT https://{endpoint}/v1/{project_id}/v2x-edge-apps/{edge_app_id}/versions/{version}Content-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "description" : "this is a test app version", "container_settings" : { "configs" : { "privileged" : false, "host_network" : true, "restart_policy" : "Never" }, "image_url" : "example.com/huawei/edge:1.0.0", "volumes" : [ { "name" : "newconfig", "destination" : "newDestination", "source" : "/user" } ] }}
  • 响应参数 状态码: 200 表11 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明:用户自定义应用唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)、美元符号($)的组合。 version String 参数说明:应用版本。 description String 参数说明:应用描述。 取值范围:只允许中文、字母、数字、下划线(_)、中文分号(;)、中文冒号(:)、中文问号(?)、中文感叹号(!)中文逗号(,)、中文句号(。)、英文引号(;)、英文冒号(:)、英文逗号(,)、英文句号(.)、英文问号(?)、英文感叹号(!)、顿号(、)、连接符(-)的组合。 created_time String 参数说明:创建时间。 last_modified_time String 参数说明:最后一次修改时间。 state String 参数说明:应用版本状态。 取值范围: DRAFT:草稿 PUBLISHED:发布 OFF_SHELF:下线 command Array of strings 参数说明:启动命令。 args Array of strings 参数说明:启动参数。 container_settings ContainerSettingsDTO object 参数说明:容器配置。 publish_time String 参数说明:发布时间。 off_shelf_time String 参数说明:下线时间。 表12 ContainerSettingsDTO 参数 参数类型 描述 configs ContainerConfigsDTO object 参数说明:容器特殊参数。 image_url String 参数说明:镜像存储地址。 envs Object 参数说明:环境变量。 volumes Array of VolumeDTO objects 参数说明:卷配置。 resources ResourceDTO object 参数说明:资源配额。 ext_devices Array of ExtDevice objects 参数说明:外挂设备配置。 表13 ContainerConfigsDTO 参数 参数类型 描述 privileged Boolean 参数说明:开启容器特权模式。 host_network Boolean 参数说明:是否使用主机网络模式。 restart_policy String 参数说明:重启策略,容器执行健康检查后失败后的策略。 container_port_list Array of ContainerPortDTO objects 参数说明:容器端口映射值。 表14 ContainerPortDTO 参数 参数类型 描述 container_port Integer 参数说明:构成一对映射的容器端口。 host_port Integer 参数说明:构成一对映射的物理机对应网卡端口。 host_ip String 参数说明:对应网卡地址。 表15 VolumeDTO 参数 参数类型 描述 name String 参数说明:卷名称。 type String 参数说明:挂载类型。 source String 参数说明:源路径。只允许输入数字、大写字母、小写字母、下划线(_)、横杠(-)、斜线(/) destination String 参数说明:卷挂载路径。 read_only Boolean 参数说明:只读,默认只读。 表16 ResourceDTO 参数 参数类型 描述 limits ResourceConfigDTO object 参数说明:允许容器使用的最大资源。 requests ResourceConfigDTO object 参数说明:容器需要使用的最小资源。 表17 ResourceConfigDTO 参数 参数类型 描述 cpu Float 参数说明:cpu个数。 memory Float 参数说明:内存大小。 gpu Float 参数说明:gpu个数。 npu Float 参数说明:npu个数。 表18 ExtDevice 参数 参数类型 描述 source String 参数说明:源路径。 destination String 参数说明:卷挂载路径。 cgroup_permissions String 参数说明:只读,默认MRW。
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 platform_type String 参数说明:平台类型。 取值范围: DRIS:华为路网数字化平台 LITONG:利通 ZHONGQIYAN:中汽研 platform_para PlatformPara object 参数说明:platform_type为非DRIS时有效,表示第三方平台的对接参数 channel_status String 参数说明:华为路网数字化平台或第三方业务平台连接状态。 取值范围: ONLINE:在线 OFFLINE:离线 INITIAL:初始化 表6 PlatformPara 参数 参数类型 描述 address String 参数说明:第三方业务平台的ip地址和端口。 username String 参数说明:鉴权用户名。 取值范围:长度不超过255,只允许字母、数字、下划线(_)、问号(?)、反引号(')、井号(#)、左小括号(()、右小括号())、点(.)、逗号(,)、与(&)、百分号(%)、At(@)、感叹号(!)、连接符(-)的组合。 passwd String 参数说明:鉴权密码,ITS800或者ATLAS500的密码 取值范围:长度不超过255,只允许字母、数字、下划线(_)、问号(?)、反引号(')、井号(#)、左小括号(()、右小括号())、点(.)、逗号(,)、与(&)、百分号(%)、At(@)、感叹号(!)、连接符(-)的组合。
  • 请求示例 PUT https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channelContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "platform_type" : "DRIS", "platform_para" : { "address" : "127.0.0.1:8080", "username" : "username", "passwd" : "password1" }}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明:用户自定义应用唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)、美元符号($)的组合。 description String 参数说明:应用描述。 取值范围:只允许中文、字母、数字、下划线(_)、中文分号(;)、中文冒号(:)、中文问号(?)、中文感叹号(!)中文逗号(,)、中文句号(。)、英文引号(;)、英文冒号(:)、英文逗号(,)、英文句号(.)、英文问号(?)、英文感叹号(!)、顿号(、)、连接符(-)的组合。 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_published_version String 参数说明:最新发布版本。
  • 响应示例 状态码: 200 Ok { "edge_app_id" : "13125481330735066213121901779837", "description" : "this is a test app", "created_time" : "2021-12-23T12:29:08", "last_modified_time" : "2021-12-23T12:29:09.367", "last_published_version" : null}
  • 请求示例 POST https://{endpoint}/v1/{project_id}/v2x-edgesContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "name" : "v2xedgeName", "description" : "v2xedge01", "esn" : "ESN01234567", "ip" : "127.0.0.1", "port" : "8880", "hardware_type" : "ATLAS", "position_description" : "position01", "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" } ]}
  • 响应参数 状态码: 201 表8 响应Body参数 参数 参数类型 描述 v2x_edge_id String 参数说明:Edge ID,用于唯一标识一个Edge name String 参数说明:名称。 取值范围:长度不低于1不超过128,只允许中文、字母、数字、下划线(_)、连接符(-)的组合。 description String 参数说明:Edge描述。 取值范围:长度不超过255,只允许中文、字母、数字、下划线(_)、中文分号(;)、中文冒号(:)、中文问号(?)、中文感叹号(!)中文逗号(,)、中文句号(。)、英文引号(;)、英文冒号(:)、英文逗号(,)、英文句号(.)、英文问号(?)、英文感叹号(!)、顿号(、)、连接符(-)的组合。 esn String 参数说明:设备编码,全局唯一。 取值范围:长度不超过64,只允许字母、数字、以及_等字符的组合。 ip String 参数说明:网络IP,例如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 参数说明:经纬度坐标。 local_rsus Array of strings 参数说明: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:删除中 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。 表9 Location 参数 参数类型 描述 lat Number 参数说明:定义纬度数值,北纬为正,南纬为负,单位°,精度小数点后7位。 lon Number 参数说明:定义经度数值。东经为正,西经为负。单位°,精度小数点后7位。 表10 LocalSegmentRsu 参数 参数类型 描述 segment_id String 参数说明:分段Id,填写雷达设备对应序号(sequence_no)。 取值范围:数字字符串。 rsu_esn String 参数说明:RSU的设备序列号。 取值范围:只允许长度不小于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,默认关闭。 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(@)、感叹号(!)、连接符(-)的组合。 表12 ResponseEdgeAuthentication 参数 参数类型 描述 user_name String 参数说明:edge接口鉴权用户名。 取值范围:长度不小于8,不大于32,只允许数字字母下划线组合,且不能以数字下划线开头,不能有中文和特殊字符,用户名不能与密码相同。
  • 响应示例 状态码: 201 Created { "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 }, "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" : "INSTALLED", "node_id" : "536434354358674544874543587", "created_time" : "2020-09-01T01:37:01Z", "last_modified_time" : "2020-09-01T01:37:01Z"}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明:满足查询条件的记录数。 apps Array of V2XEdgeAppResponseDTO objects 参数说明:已部署的边缘应用列表。 表5 V2XEdgeAppResponseDTO 参数 参数类型 描述 v2x_edge_id String 参数说明:Edge ID,用于唯一标识一个Edge。 edge_app_id String 参数说明:用户自定义应用唯一ID。 app_version String 参数说明:应用版本,比如1.0.0。 status String 参数说明:应用部署状态。 取值范围: UNINSTALLED:待部署 INSTALLED:部署中 OFFLINE:离线 ONLINE:在线 UPGRADING:升级中 DELETING:删除中 RUNNING:运行中
  • 响应示例 状态码: 200 OK { "count" : 1, "versions" : [ { "edge_app_id" : "17442350272644024878411165216381", "version" : "2.0.1", "description" : "hello", "created_time" : "2021-12-23T12:42:50", "last_modified_time" : "2021-12-23T12:42:50", "state" : "DRAFT", "publish_time" : null, "off_shelf_time" : null } ]}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明:总记录数。 versions Array of QueryEdgeAppVersionBriefResponseDTO objects 参数说明:列举每条记录。 表5 QueryEdgeAppVersionBriefResponseDTO 参数 参数类型 描述 edge_app_id String 参数说明:用户自定义应用唯一ID。 version String 参数说明:应用版本。 description String 参数说明:应用描述。 取值范围:只允许中文、字母、数字、下划线(_)、中文分号(;)、中文冒号(:)、中文问号(?)、中文感叹号(!)中文逗号(,)、中文句号(。)、英文引号(;)、英文冒号(:)、英文逗号(,)、英文句号(.)、英文问号(?)、英文感叹号(!)、顿号(、)、连接符(-)的组合。 created_time String 参数说明:创建时间。 last_modified_time String 参数说明:最后一次修改时间。 state String 参数说明:应用版本状态。 取值范围: DRAFT:草稿 PUBLISHED:发布 OFF_SHELF:下线 publish_time String 参数说明:发布时间。 off_shelf_time String 参数说明:下线时间。