功能描述该接口用于向VCM子系统的指定人脸库中添加人脸照片。该照片中应包含指定人员的人脸图片。注意事项同一人员在人脸库的人脸图片不能超过五张。一个人脸库最大支持100万人脸。基本信息接口名称添加人脸图片v1.1接口路径/io-adapter/south/face-recognition/v1.1/face-picture/addHTTP方法POST请求参数请求参数如表1所示。表1 请求消息参数说明参数名称类型必选(M)/可选(O)位置参数含义X-HW-IDStringMHeaderROMA授权的应用ID。X-HW-APPKEYStringOHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。channelStringMHeader选择的子系统渠道。由上层应用携带，供ROMA平台做路由选择。厂家无需实现。repositoryCodeStringMBody人脸库标识。“增加人脸库”接口返回的人脸库标识。imageUrlStringOBody人脸图片的URL路径与imageBase64二者选一。长度范围：不超过255个字符。imageBase64StringOBody人脸图片内容的BASE64编码的字符串。与imageUrl二者选一。Base64编码后大小不超过5M。图片为JPG/JPEG/BMP/PNG格式。imageIdStringOBody人脸图片的唯一ID，与当前图像绑定。若用户没提供，系统会生成一个。该ID长度范围为1～36位，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。VCM不支持personIdStringMBody人脸图片所包含的人员实例的ID。一张人脸照片建议仅包含一个人员的正脸。如果照片中有多个人脸，则表示此人员实例的脸是照片中尺寸最大的那个脸。长度范围：0-9A-Fa-f，长度24个字符extensionobjectOBody扩展对象。用于携带厂家定义的特有字段。表2 extension参数说明参数名称类型必选(M)/可选(O)位置参数含义nameStringOBody人员姓名，支持中文、英文、数字和空格，首位不为特殊字符，长度[1,255]。genderStringOBody人员性别：0：男1：女-1：未知credentialTypeStringOBody证件类型：0：身份证1：护照2：学生证3：军官证4：驾照5：其他credentialNumberStringOBody证件号，支持英文、数字、()，长度[1,255]。请求样例{ "repositoryCode": "5d11c13a066b980884971778", "imageBase64": "/9j/4...", "personId": "5cf8b755066b980884970701" }响应参数响应参数如表3所示。表3 响应消息参数说明参数名称类型参数含义resultoutputs接口响应参数。成功时返回下方结果，失败或者数据为空时，不返回result内部的内容结构，仅返回null。resCodeString返回码。具体请参考“人员匹配错误码”。resMsgString返回消息。originalResInfooriginalResInfo原始响应消息。表4 outputs参数说明参数名称类型参数含义facesFaceStructure[]照片中包含的人脸结构。如果照片中包含多张人脸，则返回一个列表。表5 FaceStructure参数说明参数名称类型参数含义personIdString人脸图片所包含的人员实例的ID固定为24个字符。faceIdString人脸ID。支持1~36个字符。表6 originalResInfo参数说明参数名称类型参数含义originalResCodeString原始返回码。originalResMsgString原始返回消息。响应样例{ "result": { "faces": [ { "faceId": "5d1325f6066b980c1aa4ee6b", "personId": "5cf8b755066b980854970701" } ] }, "resCode": "0", "resMsg": "Success.", "originalResInfo": { "originalResCode": "0", "originalResMsg": "success" } }

功能描述该接口用于查询人员匹配子系统中的所有人脸库或指定人脸库。注意事项无。基本信息接口名称查询人脸库v1.1接口路径/io-adapter/south/face-recognition/v1.1/face-repository/queryHTTP方法POST请求参数请求参数如表1所示。表1 请求消息参数说明参数名称类型必选(M)/可选(O)位置参数含义X-HW-IDStringMHeaderROMA授权的应用ID。X-HW-APPKEYStringOHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。channelStringMHeader选择的子系统渠道。由上层应用携带，供ROMA平台做路由选择。repositoryNameStringOBody人脸库名称，不填则返回所有人脸库列表。startStringOBody当前页码数，范围为正整数。不填则返回全量数据。默认为1。sizeStringOBody分页大小。不填则返回全量数据。start和size若值填一个，则另一个按默认值处理。默认为100。取值范围 1-1000。请求样例{ "repositoryName": "j234ing666" }响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resultoutputs接口响应参数。成功时返回下方结果，失败或者数据为空时，不返回result内部的内容结构，仅返回null。resCodeString返回码。具体请参考“人员匹配错误码”。resMsgString返回消息。originalResInfooriginalResInfo原始响应消息。表3 outputs参数说明参数名称类型参数含义repositoryRepository[]符合查询条件的人脸库列表。如果未查询到符合条件的人脸库，返回空数组。countInt符合查询条件的人脸库数量。表4 Repository参数说明参数名称类型参数含义repositoryCodeString人脸库标识。支持1~32个字符。repositoryNameString人脸库名称。支持1~32个字符。descriptionString库描述。支持0~128个字符。表5 originalResInfo参数说明参数名称类型参数含义originalResCodeString原始返回码。originalResMsgString原始返回消息。响应样例{ "resCode": "0", "resMsg": "Success.", "originalResInfo": { "originalResCode": "0", "originalResMsg": "success" }, "result": { "repository": [ { "repositoryCode": "5cfe0580066b9808849709a4", "repositoryName": "j234ing666", "description": "jing" } ], "count": 1 } }

【功能模块】接https://bbs.huaweicloud.com/forum/thread-196457-1-1.html 帖子华为智慧园区开发工程师认证进阶课 实战课（https://qa6-dev.besclouds.com/） 统一事件集成第三方系统 新增设备后可以正常触发定义事件转发请求roma中定义的网关接口，但是在roma中却无法查询到请求的日志。无法完成进阶课程日志截图【操作步骤&问题现象】1、IOC新增设备触发定义的转发事件，事件请求roma定义的api接口2、roma的api网关中无法查询到api分析日志 【截图信息】【日志信息】（可选，上传日志内容或者附件）

【功能模块】华为智慧园区开发工程师认证进阶课 实战课（https://qa6-dev.besclouds.com/） 统一事件集成第三方系统【操作步骤&问题现象】1、根据操作指导书完成“事件处置服务IO”应用开发，并配置统一事件转发规则2、Live Data > API测试 返回结果为null【截图信息】1、API设计2、API开发3、API测试【日志信息】（可选，上传日志内容或者附件）

【功能模块】   华为智慧园区开发工程师认证进阶课 实战课（https://qa6-dev.besclouds.com/） 统一事件集成第三方系统 新增设备后不能正常触发事件   租户帐号和密码私聊发【操作步骤&问题现象】1、IOC新增设备 或者 脚本直接调试2.物流是从页面新增设备还是 直接调试都是通过roma调用  io.unified.event.apiservice 的 /service/EventBridge/0.1.0/event/addEvent 返回都是 SYSTEM_ERROR【截图信息】下图为直接调试日志【日志信息】（可选，上传日志内容或者附件）附件日志 2022-08-05 20:08:18.538  和  2022-08-05 20:08:18.681 为IOC直接新增设备的日志

【功能模块】  用户登录【操作步骤&问题现象】1、注册业务用户账号2、调用/service/CM_Identity/0.1.0/login，按照说明文档，应有响应信息，但实际上却报"您没有足够权限执行执行脚本"   麻烦问下是什么原因？【截图信息】【日志信息】（可选，上传日志内容或者附件）

智慧园区统一接入之通过IoT网关接入集成架构https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195894智慧园区统一接入之通过IoT网关接入基线已集成设备（上）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195895智慧园区统一接入之通过IoT网关接入基线已集成设备（下）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195896智慧园区统一接入之开发设备IO场景介绍https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195983智慧园区统一接入之设备IO开发规划https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195984智慧园区统一服务之——什么是统一设备服务https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196118智慧园区统一服务之——统一设备服务的优势和应用场景https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196119智慧园区集成资产说明——如何获取IO资产包健康状态https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196153智慧园区集成资产说明——如何获取南向子系统连接状态https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196154智慧园区集成资产说明——增加人脸库接口说明https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196430智慧园区集成资产说明——删除人脸库接口说明https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196431智慧园区集成资产说明——查询人脸库接口说明cid:link_14智慧园区集成资产说明——添加人脸图片接口说明cid:link_13智慧园区集成资产说明——对接南向子系统新基点IoT指令下发接口说明cid:link_15智慧园区集成资产说明——对接南向子系统新基点IoT注册设备接口说明cid:link_16智慧园区统一运维概述https://bbs.huaweicloud.com/forum/thread-0223960005232380004-1-1.html智慧园区统一运维规范和要求https://bbs.huaweicloud.com/forum/thread-0221960005871960006-1-1.html历史精选技术贴汇总：智慧园区BBS论坛七月技术贴汇总一览（七月持续更新）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=193937智慧园区BBS论坛六月技术贴汇总一览（六月持续更新）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=190895

功能描述该接口用于删除EI系统的人脸库。注意事项无。基本信息接口名称删除人脸库v1.1接口路径/io-adapter/south/face-recognition/v1.1/face-repository/deleteHTTP方法POST请求参数请求参数如表1所示。表1 请求消息参数说明参数名称类型必选(M)/可选(O)位置参数含义X-HW-IDStringMHeaderROMA授权的应用ID。X-HW-APPKEYStringOHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。channelStringMHeader选择的子系统渠道。由上层应用携带，供ROMA平台做路由选择。厂家无需实现。repositoryCodeStringMBody“增加人脸库”接口返回的人脸库标识。请求样例{ "repositoryCode": "test03" }响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resCodeString返回码。具体请参考“人员匹配错误码”。resMsgString返回消息。originalResInfooriginalResInfo原始响应消息。表3 originalResInfo参数说明参数名称类型参数含义originalResCodeString原始返回码。originalResMsgString原始返回消息。响应样例{ "resCode": "0", "resMsg": "Success.", "originalResInfo": { "originalResCode": "0", "originalResMsg": "Success." } }

功能描述该接口用于向EI子系统添加人脸库，用于人员匹配场景。注意事项无。基本信息接口名称增加人脸库v1.1接口路径/io-adapter/south/face-recognition/v1.1/face-repository/addHTTP方法POST请求参数请求参数如表1所示。表1 请求消息参数说明参数名称类型必选(M)/可选(O)位置参数含义X-HW-IDStringMHeaderROMA授权的应用ID。X-HW-APPKEYStringOHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。channelStringMHeader选择的子系统渠道。由上层应用携带，供ROMA平台做路由选择。厂家无需实现。repositoryNameStringMBody库名称。必须唯一。后续不可更改，只能删除。不支持中文，只支持数字、字母和下划线。长度范围：1~32个字符。建议人脸库的名称不要以下划线（_）开头，否则会无法采集人脸数量。descriptionStringOBody库描述。不支持。capacityIntOBody库容量，人脸库最大的容量。默认容量由各个厂家自行定义。填写1万整数倍的数字，例如：30000。默认为100000，最大值为100000。extensionObjectOBody扩展对象。用于携带厂家定义的特有字段。自定义字段不能以系统保留字段vector、bounding_box、external_image_id、face_id、create_time、_id、_all、_source等字段命名。Json字符串不校验重复性，自定义字段的key值长度范围为[1,36]，String类型的value长度范围为[1,256]，具体参见自定义字段。请求样例{ "repositoryName": "test03" }响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resultresult接口响应参数。成功时返回下方结果，失败或者数据为空时，不返回result内部的内容结构，仅返回null。resCodeString返回码。具体请参考“人员匹配错误码”。resMsgString返回消息。originalResInfooriginalResInfo原始响应消息。表3 result参数说明参数名称类型参数含义repositoryCodeString人脸库标识。长度范围：支持1~32字符。表4 originalResInfo参数说明参数名称类型参数含义originalResCodeString原始返回码。originalResMsgString原始返回消息。响应样例{ "resCode": "0", "resMsg": "Success.", "originalResInfo": { "originalResCode": "0", "originalResMsg": "Success." }, "result": { "repositoryCode": "test03" } }

【功能模块】查询实时天气信息（getWeather）查询实时天气信息。该接口主要用于查询实时天气信息，获取实时气温。注意事项无。基本信息接口名称getWeather接口路径/service/SmartCampus__EnvironmentMonitoring/0.1.0/weather/query接口协议HTTPS接口方法POST【操作步骤&问题现象】1、请问该模块是否只能在APP中使用，WEB端能否调用；2、请问该天气数据来自哪里，是否准确，是否收费；3、该天气数据比较简单，只有城市、三种气温、天气（阴晴雨雪），有没有数据更丰富的接口；【截图信息】【日志信息】（可选，上传日志内容或者附件）

功能描述该接口用于获取南向子系统的连接状态。注意事项无。基本信息接口名称获取南向子系统连接状态外部接口路径/io-adapter/south-connection?appid={appid}HTTP方法GET请求参数请求参数如表1所示。表1 请求消息参数说明参数名称必选(M)/可选(O)类型位置参数含义X-HW-IDMStringHeaderROMA授权的应用ID。X-HW-APPKEYOStringHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。appidMStringQueryString应用ID。请求样例无响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resCodeString返回码。resMsgString返回消息。resultList<SouthConnectionStatus>查询返回的IO资产健康状态。表3 SouthConnectionStatus参数说明参数名称类型参数含义appIdStringIO资产包的应用ID。appNameStringIO资产包的应用名称。numberInt南向子系统环境的编号。statusInt南向环境的连接状态。0：正常1：异常响应样例{ "resCode": "0", "resMsg": "success.", "result": [{ "status": 0, "number": 1, "appName": "华为云IoT边缘节点", "appId": "io.huawei.oc.edge.iot" }] }

功能描述该接口用于IO资产包的健康状态。注意事项无。基本信息接口名称获取IO资产包健康状态外部接口路径/io-adapter/liveness?appid={appid}HTTP方法GET请求参数请求参数如表1所示。表1 请求消息参数说明参数名称必选(M)/可选(O)类型位置参数含义X-HW-IDMStringHeaderROMA授权的应用ID。X-HW-APPKEYOStringHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。appidMStringQueryString应用ID。请求样例无响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resCodeString返回码。resMsgString返回消息。resultIOStatus查询返回的IO资产健康状态。表3 IOStatus参数说明参数名称类型参数含义appIdStringIO资产包的应用ID。appNameStringIO资产包的应用名称。statusIntIO资产包的状态。0：正常1：异常响应样例{ "resCode": "0", "resMsg": "success.", "result": { "status": 0, "appName": "华为云EI人员匹配服务IO", "appId": "io.huawei.ei.faceRecognition" } }

优势可扩展的物模型数据库内嵌标准物模型设备库，能支持市面上大部分的设备类型。用户也可以根据业务需要提交新的物模型到物模型数据库，从而在业务中使用。屏蔽设备多样性园区设备集中管理，对不同品牌的同类设备提供标准化的点位数据和标准化的控制命令。底层设备品牌发生变化时，上层应用不需要重新适配。统一管理提供标准化的API用于设备信息维护，包括增加、删除、修改、查询等。应用场景需要和物联网设备进行交互的场景，都会用到统一设备服务。例如：考勤系统中，需要根据视频监控捕捉到的人脸信息来判断员工是否按时到场。考勤系统通过统一设备服务提供摄像机的操作API获取数据，并提供给人脸分析模块做员工到场分析。访客系统中，客人可以使用手机二维码图片来打开门禁道闸。统一设备服务管理门禁道闸，访客系统通过统一设备服务下发指令给目标道闸，控制道闸开闭。安防系统中，需要获取烟感、温感设备的读数来判断是否有火险告警。IoT系统定时获取烟感温感设备的信息，上报给统一设备服务。统一设备服务通过触发器的形式通知安防系统对可能发生的火险做应对。

在IoT业务中，有许多需要业务应用和物联网设备产生交互的场景，包括获取设备信息、设获取设备数据、操控设备行为等。这些场景中涉及的物联网设备品牌纷杂，种类繁多，协议多样，给业务应用的开发带来了诸多不便。为了能让业务开发人员更方便高效地实现与物联网设备交互的功能，我们对物联网设备进行业务抽象，提供统一设备服务。统一设备服务提供了对物联网设备的建模、管理、交互等能力。定义了物联网设备的模型和服务上的规范。不同的业务应用，所看到的设备的模型和服务都是相同结构的，这样有助于业务应用之间的信息交互。提供了对不同物联网设备的统一抽象机制。对于同一类型的物联网设备，即使是来自不同厂家的产品，也可以抽象成相同的设备规格。因此业务应用使用设备能力时，无需针对不同设备产品做分别的适配。提供了标准的IoT网关集成接口。与不同的网关集成时，只需要准备相应的适配器，而上层业务应用可以保持不变。统一设备服务的组成框图如下：图1 统一设备服务提供全网共用的设备库，对各个开发者提供常用的设备规格。针对于新的IoT设备，在现有的设备规格不满足的情况下，用户可以通过设备库应用提交新的规格，经过设备库管理人员审批后入库。设备规格管理，用于管理本租户使用的设备规格。用户可以通过设备BO配置页面录入规格，也可以从设备库拉取项目所需的设备规格。设备实例管理，用于管理接入到统一设备服务的所有设备。设备主数据应用，提供了设备实例的查看和管理界面。

开发流程设备IO的开发流程如表1，开发规范请参考《集成平台开发规范》。表1 设备IO开发流程流程说明注册应用在ROMA平台注册设备IO的应用名称和应用ID。创建Topic并设置订阅/发布创建接收设备原始消息的Topic、接收设备原始告警消息的Topic。环境配置/密码配置通过环境配置/密码配置，将参数或者密码设为全局变量，后续代码中通过全局变量获取对应参数、参数值、密钥和密码等。开发消息上报接口设备IO的消息上报接口，共包含3个LiveData接口。开发指令下发接口设备IO的指令下发接口，1个LiveData接口。设备IO数据规划规划应用ID、Topic和接口URL，如表2所示。表2 设备IO的数据规划参数样例说明租户GTM001下面样例中的“GTM001”为租户名称。本章节在开发过程中，要在设计内容的基础上增加后缀“__GTM001”或者前缀“GTM001__”，即携带租户信息。deviceTypeTurnstile_BPIoT系统对应的IO通过消息体中的“deviceType”参数，确定要路由的设备IO。其中“BP”指新基点IoT（BasePoint），在多IoT场景中以“deviceType”中的后缀（例如“_BP”）区分不同的IoT。在实际开发过程中，根据设备实际接入的IoT系统来增加后缀。应用IDGTM001__io.device.basepoint.Turnstile_BP人行闸机IO在ROMA平台的应用ID。其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。应用名称GTM001__人行闸机设备IO人行闸机IO在ROMA平台的应用名称。Topic接收新基点IoT发来的设备原始消息的Topic：T_IO_DATACHANGED_Turnstile_BP__GTM001人行闸机IO需要2个Topic接收新基点IoT发来的消息：一个接收设备原始消息，一个接收设备告警消息。其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。接收新基点IoT发来的设备原始告警消息的Topic：T_IO_ALARM_Turnstile_BP__GTM001接收设备信息变化的标准Topic：T_IO_DEVICE_DATACHANGED__GTM001消息格式标准化之后：转换后的设备原始消息，推送给设备信息变化标准Topic。转换后的设备告警消息，推送给设备告警的标准Topic。这2个Topic只需要创建一次即可，所有设备IO转换后的标准消息都推送给它们，不需要重复创建。接收设备告警的标准Topic：T_IO_DEVICE_ALARM__GTM001API设备数据变化消息回调（人行闸机）URL：/io/GTM001__io.device.basepoint.Turnstile_BP/device/data-changed人行闸机IO的2个LiveData接口，分别订阅如下2个Topic进行数据格式标准化。T_IO_DATACHANGED_Turnstile_BP__GTM001T_IO_ALARM_Turnstile_BP__GTM001其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。设备告警消息回调（人行闸机）URL：/io/GTM001__io.device.basepoint.Turnstile_BP/device/alarm开放订阅关系的配置接口URL：/io/GTM001__io.device.basepoint.Turnstile_BP/device/mqsSet消息订阅接口，开放订阅关系的配置接口，用于订阅设备变化、告警消息。人行闸机设备IO指令下发URL：/io/GTM001__io.device.basepoint.Turnstile_BP/south/send-command/0.1.0人行闸机设备IO指令下发包含一个LiveData接口，名称为“指令下发（人行闸机）”。