云服务器内容精选

  • URI GET /v1/{project_id}/alarm-manager/alarms 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询的起始位置,取值范围为非负整数,默认为0 limit 否 Integer 每页显示的条目数量,取值范围1~100,默认为100 device_id 否 String 设备ID
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total Integer 满足条件的设备告警总数 data Array of GetDeviceAlarmArrayObject objects 设备告警实体列表 表5 GetDeviceAlarmArrayObject 参数 参数类型 描述 id String 设备告警记录ID name String 设备告警名称 alarm_id Integer 设备告警ID level String 设备告警等级,紧急告警(critical),严重告警(major),一般告警(minor) platform String 设备平台 impact String 设备告警的影响 detail String 设备告警详情内容 reason String 设备告警原因 deal_suggestion String 设备告警处理建议 create_time Long 创建时间(时间戳)
  • 响应示例 状态码: 200 获取设备告警列表成功 { "total" : 0, "data" : [ { "id" : "6b0e806f35c2470a825da1f1ab05caf5", "name" : "安装在设备HiLens_69上的技能test-unzip异常且无法恢复", "alarm_id" : 5, "level" : "critical", "platform" : "hilens", "impact" : "业务中断", "detail" : "多次尝试恢复技能均失败", "reason" : "技能10分钟内退出就会被认为是异常退出", "deal_suggestion" : "查看Log分析原因", "create_time" : 1636451227616 } ] }
  • 设备导入文件说明 设备的导入文件内容要求见表1。 表1 设备导入文件内容说明 列名 描述 取值要求 DeviceName 设备名称。 必填,复杂度要求与页面创建相同。 ProductSerial 设备所属产品的产品标识。 必填,产品标识应已存在。 ParentDeviceClient 设备所属网关设备的客户端ID。 选填,网关设备应已存在。 ClientID 客户端ID。 选填。 DeviceIdentifier 设备标识。 必填,复杂度要求与页面创建相同。 Username 用户名。 选填。 Password 密码。 选填,复杂度要求与页面创建相同。 DeviceType 设备类型。 必填,根据所属产品的协议类型决定。 MQTT:COMMON。 Modbus:MODBUS。 OPC UA:OPCUA。 Remark 设备描述。 选填。 customTopic 自定义topic。 选填,建议在页面创建。 发布权限的TOPIC格式为:产品标识/out/设备标识/TOPIC名称。 订阅权限的TOPIC格式为:产品标识/in/设备标识/TOPIC名称。 多个TOPIC之间使用英文分号分隔。 Enable 设备状态。 必填,启用:0,禁用:1。
  • 前提条件 导入设备前,请确保设备所属的集成应用已创建,否则请提前创建集成应用。 导入设备前,请确保设备所属的产品已创建,否则请提前创建产品。 导入设备前,请检查导入设备的实例中是否存在重名设备,若存在重名设备,会导致导入设备失败。 导入设备前,请确保设备的配额满足需求。 导入文件格式为csv,并需要使用UTF-8 BOM编码。 在使用导出的文件导入设备时: 如果要新增设备,则需要另外新建导入文件,并在新建的文件中添加新的设备信息。 设备导入文件中表头的名称和顺序固定不能更改,表头名称请参考设备导入文件说明。 确认导入文件是否从老版本实例中导出:打开导入文件,查看是否存在“Base64:”开头的字段值。如果没有“Base64:”开头的字段值,则说明是老版本实例导出的文件。 如果是老版本实例导出的文件,需要重命名文件,在文件名后添加“-none-base64-prefix”,例如原文件名为“import.csv”,则需要重命名为“import-none-base64-prefix.csv”。 若使用Excel工具编辑导入文件,在编辑完成后需要按如下操作保存。 在Excel中保存时,以另存的方式保存为“ CS V(逗号分隔)(*.csv)”类型文件。 使用文本编辑器打开1中保存的csv格式文件,并再次另存,另存时编码选择“带有 BOM 的 UTF-8”,保存后即得到最终的csv格式导入文件。
  • 边缘节点和子设备均在线,为什么子设备上报的数据在IoTDA平台查看不到? 查看EdgeHub日志(专业版节点日志路径:/var/IoTEdge/log/sys_edge_hub/log/edge-hub-running.log;专业版节点日志路径:/var/IEF/app/log/sys_edge_hub/log/edge-hub-running.log),触发子设备数据上报时,查看日志内容是否有异常信息。 若日志提示“No services”,为该设备上报的数据与设备产品的serviceId对应不上。当前边缘节点不感知产品的更新。若新建一个空白的设备产品,为边缘节点创建子设备,然后修改设备产品新增服务和属性,则此时设备上报数据中的服务属性在边缘节点无感知,即会出现“No services”的异常。 当进行基于IoT边缘实现模拟MQTT设备的快速接入实践,添加边缘设备时,误操作填写了模块ID后,导致数据无法上报,删除边缘设备后重新添加。模块ID的设置代表设备接入点为该模块;空代表设备接入点为设备自身,相当于网关。 父主题: 子设备管理
  • 示例 123 HW_CHAR *pcDeviceId = stDevice.pcDeviceId; IOTA_DeviceStatusUpdate(0, pcDeviceId, “ONLINE” , “NONE”); 然后等待命令执行结果。 123456789 // 开发者注册该函数进行状态更新后的处理 HW_iNT Device_StatusUpdateHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { HW_cHAR pcCmdContentl; pcCmdContent = HW_MsgGetStr(pstMsg, EN_IOTA_DEVUPDATE_IE_RESULT); pcCmdContent = HW_MsgGetStr(pstMsg, EN_IOTA_DEVUPDATE_IE_DEVICEID); return 0;}//绑定广播接收处理函数 HW_BroadCastReg(“IOTA_TOPIC_DEVUPDATE_RSP”, Device_StatusUpdateHandler);
  • 返回结果 广播名称 广播参数 成员 描述 IOTA_TOPIC_DEVUPDATE_RSP/{deviceId} HW_MSG对象 无 设备状态更新结果。 EN_IOTA_DEVUPDATE_IE_TYPE: 枚举项 枚举值 类型 描述 EN_IOTA_DEVUPDATE_IE_RESULT 0 unsigned int 命令执行返回结果。 成功:0。 失败:1。 EN_IOTA_DEVUPDATE_IE_DEVICEID 1 String 设备ID。
  • 参数说明 字段 必选/可选 类型 描述 uiCookie 可选 HW_UINT Cookie有效值为1-65535。 pcDeviceId 必选 HW_CHAR 设备Id,该参数必须带结束符‘\0'。 pcStatus 必选 HW_CHAR 设备状态,该参数必须带结束符‘\0'。 在线: ONLINE。 离线: OFFLINE。 pcStatusDetail 必选 HW_CHAR 设备状态详细信息,该参数必须带结束符‘\0'。 无:NONE。 配置等待:CONFIGURATION_PENDING。 通信错误:COMMUNICATION_ERROR。 配置错误:CONFIGURATION_ERROR。 桥接器离线:BRIDGE_OFFLINE。 固件升级:FIRMWARE_UPDATING。 循环任务:DUTY_CYCLE。 未激活:NOT_ACTIVE。
  • 请求示例 更新终端设备,修改终端设备描述,标识属性为“true”。 { "device" : { "description" : "new description", "attributes" : { "username" : { "optional" : true, "value" : "test-new", "metadata" : { "type" : "string" } } } }}
  • 响应示例 状态码: 200 ok { "device" : { "id" : "1398f13d-f24d-4de4-8cd3-5905db1d6d9f", "name" : "device", "access_protocol" : "", "project_id" : "05e1aef9040010e22fccc009adecb056", "description" : "new description", "created_at" : "2020-09-23T02:00:22.858736Z", "updated_at" : "2020-09-23T02:12:46Z", "access_config" : { }, "attributes" : { "username" : { "value" : "test-new", "optional" : true, "metadata" : { "type" : "string" } } }, "connection_type" : "edge" }}
  • 告警管理 如果用户在控制台上设置规则引擎时,定义了响应动作为上报告警,且定义了告警属性、告警级别等,则当满足触发条件时,系统就会上报告警,需要用户密切关注设备的告警并及时进行处理,确保设备的正常运行。 例如:智能水表设备3天未上报数据,可能存在水表设备发生故障导致,平台会产生对应的告警,维护人员可通过告警信息找到对应告警的水表设备,进行快速定位维修。 告警的等级划分及处理建议: 致命:已造成业务中断或可能引起设备不可用的故障,需要立即处理。 严重:对设备产生部分影响或对系统性能造成影响的故障,需要采取纠正措施,防止更为严重的故障发生。 一般及警告:对设备或系统没有影响,系统检测到潜在或即将发生影响业务的故障,需排查潜在故障。 用户在控制台上可以查看某应用下的所有设备的告警信息,也可以查看单个设备的告警信息。 所有设备告警信息 在“告警”界面上: 单个设备告警信息 在设备列表中,单击具体的设备进入到设备的详情页面,选择“告警”页签。
  • 查看审计日志 用户在使用 物联网平台 的过程中,系统会以日志形式收集并记录用户及平台的操作及结果,当某项功能发生异常时,用户可以根据日志的记录信息定位并处理故障问题。 物联网平台提供在控制台上根据日志类型(包括操作日志、安全日志、个人数据查询日志、业务日志)、结果、创建时间对日志进行搜索和查看,同时能够导出筛选后的日志。 日志类型 日志说明 操作日志 记录用户和系统所做的操作和结果,用于跟踪和审计。 对应用的操作:如在应用详情下,进行保存配置、恢复默认配置、上传logo、查询详情等操作。 对资源的操作:如导入产品模型、查看应用首页报表、查询设备详情等。 安全日志 记录涉及系统安全操作信息,如创建用户、登录、用户确认隐私声明等,用户了解系统安全操作相关信息,及时发现潜在的安全隐患并进行处理。 个人数据查询 记录用户对账户进行的操作和结果,如查询用户列表、查询企业列表等,用于跟踪和安全审计。 业务日志 记录涉及平台业务的操作及结果,例如创建设备、设备登录等,用于跟踪设备侧、应用侧业务相关信息,及时发现问题并处理。
  • R40配置 在R40上需要对传感器的参数进行配置: 风速变速器相关配置: R40上电后,在自己的电脑上连接King开头的wifi,连上后在浏览器中输入地址192.168.3.1进入R40的配置界面。 输入用户名(默认为admin)和密码(默认无密码)后,单击“登录”按钮。 单击上方菜单栏“RTU I/O”,选中“模拟量接入”,进入模拟输入配置界面。 在AIN1输入一行(因为风速变速器选择的是该口)中,选择“电流4~20mA”(风速变速器的输出为该值)。并且按照传感器推荐的将最小值设置为0,最大值设置为30,单位设置为m/s。 设置完毕后,单击“保存并应用”。 通过旋转风速变速器的扇叶,然后刷新当前的配置页,可以看到“当前值”那一栏中有数据,说明已经能采集到传感器的数据。 气象多要素百叶箱相关配置: R40上电后,在自己的电脑上连接King开头的wifi,连上后在浏览器中输入地址192.168.3.1进入R40的配置界面。 输入用户名(默认为admin)和密码(默认无密码)后,单击“登录”按钮。 单击上方菜单栏“应用”,选择“Modbus”主站,进入Modbus主站配置页面。 在下方的框中填写“noise”,单击“添加”按钮。添加完成后,单击“编辑”按钮(“删除”按钮旁的那一个),进入传感器的配置界面。 在配置界面,将别名设置为“噪声监测”,从机地址设置为“2”,寄存器类型设置为“16位数据”,功能码设置为“03”,寄存器起始地址设置为“0”,数据个数设置为“1”,映射地址分配设置为“手动”,映射起始地址设置为“20004”,从机接口设置为“RS485”。 设置完毕后,单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“noise”这一行的“查询”按钮,可以看到“数据值”,如果周围噪声发生改变,可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址,建议改为手动,同时设置映射地址。因为该地址跟物模型中的属性是对应的,属性名称需要设置成“REG”+ 映射起始地址。这里设置20004是因为物模型中已经设置了REG20004的属性名。 从噪声查看页单击“返回至概况”,在Modbus设置界面下方的空白框处填写“lightIntensity”,单击“添加”按钮。添加完成后,单击“编辑”按钮(“删除”按钮旁的那一个),进入传感器的配置界面。 在配置界面,将别名设置为“光照强度”,从机地址设置为“5”,寄存器类型设置为“32位数据”,功能码设置为“03”,寄存器起始地址设置为“0”,数据个数设置为“1”,映射地址分配设置为“手动”,映射起始地址设置为“20130”,从机接口设置为“RS485”。 设置完毕后,单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“lightIntensity”这一行的“查询”按钮,可以看到“数据值”,如果周围光照强度发生改变,可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址,建议改为手动,同时设置映射地址。因为该地址跟物模型中的属性是对应的,属性名称需要设置成“REG”+ 映射起始地址。这里设置20130是因为物模型中已经设置了REG20130的属性名。 从光照强度查看页单击“返回至概况”,在Modbus设置界面下方的空白框处填写“shidu”,单击“添加”按钮。添加完成后,单击“编辑”按钮(“删除”按钮旁的那一个),进入传感器的配置界面。 在配置界面,将别名设置为“湿度”,从机地址设置为“1”,寄存器类型设置为“16位数据”,功能码设置为“03”,寄存器起始地址设置为“500”,数据个数设置为“1”,映射地址分配设置为“手动”,映射起始地址设置为“20015”,从机接口设置为“RS485”。 设置完毕后,单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“shidu”这一行的“查询”按钮,可以看到“数据值”,如果周围光照强度发生改变,可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址,建议改为手动,同时设置映射地址。因为该地址跟物模型中的属性是对应的,属性名称需要设置成“REG”+ 映射起始地址。这里设置20115是因为物模型中已经设置了REG20115的属性名。 从湿度强度查看页单击“返回至概况”,在Modbus设置界面下方的空白框处填写“wendu”,单击“添加”按钮。添加完成后,单击“编辑”按钮(“删除”按钮旁的那一个),进入传感器的配置界面。 在配置界面,将别名设置为“温度”,从机地址设置为“1”,寄存器类型设置为“16位数据”,功能码设置为“03”,寄存器起始地址设置为“501”,数据个数设置为“1”,映射地址分配设置为“手动”,映射起始地址设置为“20003”,从机接口设置为“RS485”。 设置完毕后,单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“shidu”这一行的“查询”按钮,可以看到“数据值”,如果周围光照强度发生改变,可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址,建议改为手动,同时设置映射地址。因为该地址跟物模型中的属性是对应的,属性名称需要设置成“REG”+ 映射起始地址。这里设置20003是因为物模型中已经设置了REG20003的属性名。 R40上报到平台的配置: 在上方的菜单栏中选择“云平台”,选择“华为云”。“认证方式”选择“设备密钥”,设备ID和密钥在iot平台注册所得,服务ID填写“basicData”,发布周期填写60。 配置完后,单击“保存并应用”。设置完毕后,R40会自动连上华为云iot平台,并且每隔60s报一次数据。
  • 上传产品模型 产品模型是用来描述设备能力的文件,通过JSON的格式定义了设备的基本属性、上报数据和下发命令的消息格式。定义产品模型,即在物联网平台构建一款设备的抽象模型,使平台理解该款设备的功能。我们已提供开发好的产品模型,帮助您快速体验上云流程,如果您想体验产品模型的开发流程,可参考开发产品模型。 操作步骤: 在产品详情“基本信息”页面,单击“上传模型文件”。 在弹出的页面中,上传提供的产品模型(本示例的产品模型),然后单击“确定”。 图9 产品-上传模型文件