检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
超时时间内,平台每24小时向设备下发一次配置,直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应,则平台显示该设备配置任务超时失败。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述
查询设备 功能介绍 应用服务器可调用此接口查询物联网平台中指定设备的详细信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
如果升级任务正在执行中,是不允许删除任务的,如需删除,请先在任务列表中,手动停止任务后,再删除升级任务。 软固件升级失败原因 物联网平台上报的失败原因: 失败原因 原因解释 处理建议 Device Abnormal is not online 设备异常未在线 请检查设备侧。 Task
The content reported in a single request cannot exceed 1 MB. 单次请求上报的内容不能超过1MB 父主题: 设备属性上报
为成功) 9. 物联网平台向控制台/应用服务器通知升级的结果。 在下载包中断的情况下,平台支持断点续传功能。 固件升级失败原因 物联网平台上报的失败原因: 失败原因 原因解释 处理建议 Device Abnormal is not online 设备异常未在线 请检查设备侧。 Task
修改设备 功能介绍 应用服务器可调用此接口修改物联网平台中指定设备的基本信息。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
- 同步命令 以下消息类型,应用可以通过下发同步命令的方式,给终端设备发送消息,参考下发同步命令。 请使用API接口做业务调测,部分命令目前不能通过界面下发。 终端管理-设置终端参数 接口说明 请求对应的消息ID:0x8103 响应对应的消息ID:0x0001(终端通用响应) 请求示例
failure(升级包校验失败) 8:unsupported upgrade package type(升级包类型不支持) 9:insufficient memory(内存不足) 10:upgrade package installation failure(安装升级包失败) 255:internal
"test",2,1234 topic:指定的topic 默认为上报属性的topic,建议填写 +HMPUB ERR:code (发布失败,code表示失败原因) len:待发送数据长度,单位为字节 - - payload:转换为ascii码的数据,最大长度1024字节 最大支持长度2KB
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于创建产品接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响
The content reported in a single request cannot exceed 1 MB. 单次请求上报的内容不能超过1MB 父主题: 设备属性上报
MQTT场景--使用MQTT.fx接入设备发放示例 MQTT 密钥设备使用静态策略发放示例 MQTT X.509证书认证设备使用证书策略发放示例 MQTT 注册组自定义策略发放示例 MQTT 华为云X.509证书认证设备使用证书策略发放示例 MQTT 华为云证书注册组发放示例 MQTT
使用前必读 MQTT概述 MQTT标准规范参见《mqtt-v3.1.1-os.pdf》。 MQTT的语法和接口细节,请以此标准为准。设备发放目前仅支持MQTTS/HTTPS这种安全接入的设备进行发放,暂不支持MQTT/HTTP这种非安全接入的设备进行发放。 MQTT消息分为固定报头(Fixed
鉴权模板函数嵌套最大深度为5层。 模板内容体最大长度不能超过4000字符,且不能包含中文字符。 设备为密钥认证类型时,模板密码函数必须包含设备原始密钥参数(iotda::device::secret)。 使用模板鉴权时,鉴权参数username不能与自定义函数鉴权username格式重叠,否则会使用自定义函数鉴权,比如:
设备接入实例自动续费周期根据您开通自动续费的途径不同,遵循不同的规则。 在设备接入实例到期前均可开通自动续费,到期前7日凌晨3:00首次尝试自动续费,如果扣款失败,每天凌晨3:00尝试一次,直至设备接入实例到期或者续费成功。 开通自动续费后,还可以手动续费该设备接入实例。手动续费后,自动续费仍然有效,在新的到期时间前的第7天开始扣款。
OK(连接成功) serverip:设备接入服务器地址或者BS服务器地址。 默认值:BS服务器地址 +HMCON ERR:code(连接失败,code表示失败原因码) serverport:设备接入服务器端口或者BS服务器端口。 默认值:MQTTS端口8883 - id:设备ID,最大长度256。
List<Reason> 参数解释: 子设备删除失败的原因。 Reason定义表 字段名 必选/可选 类型 参数描述 device_id 必选 String 参数解释: 对应请求中指定的设备的device _id。 error_code 必选 String 参数解释: 删除失败错误原因码。 error_msg
请求参数不合法 401 Unauthorized IOTDA.000002 The request is unauthorized. 鉴权失败 403 Forbidden IOTDA.021101 Request reached the maximum rate limit. 请求已经达到限制速率
设备侧升级包下载指导 设备收到升级通知之后,通过HTTPS协议根据升级通知里面的URL下载升级包。基础版和标准版目前建议客户不校验证书可规避不能下载固件的问题。专享版如果需要校验证书,请提工单,后端帮忙配置域名。 请求方法 下载升级包的请求方法为:GET 请求消息头 附加请求消息头
场景说明 目前平台只支持MQTT/HTTP/LWM2M等标准协议接入,如果设备是其他协议(统称为第三方协议),怎么接入平台? 由于第三方协议设备不能直接接入平台,需要在平台外部完成协议转换。我们推荐使用网关来完成协议转换,将第三方协议转成MQTT协议。我们把用来进行协议转换的网关叫做协议转换网关。