检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接入方式(SECRET) secure_access 否 Boolean 参数说明：指设备是否通过安全协议方式接入，默认值为true。 true：通过安全协议方式接入。 false：通过非安全协议方式接入。 缺省值：true timeout 否 Integer 参数说明：设备验证
超时时间内，平台每24小时向设备下发一次配置，直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应，则平台显示该设备配置任务超时失败。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述
接入方式(SECRET) secure_access 否 Boolean 参数说明：指设备是否通过安全协议方式接入，默认值为true。 true：通过安全协议方式接入。 false：通过非安全协议方式接入。 缺省值：true timeout 否 Integer 参数说明：设备验证
设备鉴权 设备接入物联网平台时，需要对接入平台的设备进行鉴权认证。目前华为物联网平台支持设备使用密钥和X.509两种方式进行鉴权认证。待平台验证通过，设备成功连接到物联网平台后，就可以进行数据通信。 群组与标签 群组是一系列设备的集合，用户可以对资源空间下所有设备，根据区域、类型等不同
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
目前，NB-IoT应用场景有：智慧锁、智慧城市、智慧水表、智慧气表、智慧跟踪器、智慧仓储、智慧路灯...它们都是把原始的数据诉求给平台方，云平台通过NB模块实现数据的整合，传递给人类进行有效数据的分析使用。 父主题： 方案咨询
API概览 设备鉴权 API 说明 设备鉴权 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取a
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见
OK（连接成功） serverip：设备接入服务器地址或者BS服务器地址。 默认值：BS服务器地址 +HMCON ERR：code（连接失败，code表示失败原因码） serverport：设备接入服务器端口或者BS服务器端口。 默认值：MQTTS端口8883 - id：设备ID，最大长度256。
设备接入实例自动续费周期根据您开通自动续费的途径不同，遵循不同的规则。 在设备接入实例到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至设备接入实例到期或者续费成功。 开通自动续费后，还可以手动续费该设备接入实例。手动续费后，自动续费仍然有效，在新的到期时间前的第7天开始扣款。
OTA升级支持网关模式 1.3.2 功能增强 更新服务器ca证书 1.3.1 修复 修复空指针异常，MQTT对象未释放等问题。 1.3.0 新功能 支持通过OBS升级软固件包 1.2.0 新功能 增加泛协议功能 1.1.1 功能增强 添加网关删除子设备功能，完善中英文描述。 1.1.0 新功能
OTA升级支持网关模式 1.3.2 功能增强 更新服务器ca证书 1.3.1 修复 修复空指针异常，MQTT对象未释放等问题。 1.3.0 新功能 支持通过OBS升级软固件包 1.2.0 新功能 增加泛协议功能 1.1.1 功能增强 添加网关删除子设备功能，完善中英文描述。 1.1.0 新功能
重置设备密钥，携带指定密钥时平台将设备密钥重置为指定的密钥，不携带密钥时平台将自动生成一个新的随机密钥返回。 冻结设备 冻结设备，设备冻结后不能再连接上线，可以通过解冻设备接口解除设备冻结。注意，当前仅支持冻结与平台直连的设备。 解冻设备 解冻设备，解除冻结后，设备可以连接上线。 重置设备指纹
策略Topic定义示例 描述 想通过topic区分不同设备的自定义上报时。 “test/${devices.deviceId}/topic” 允许Topic为“test/${本设备ID}/topic”的主题订阅或发布。有利于设备间数据隔离。 想通过topic区分不同设备的自定义上
标签介绍：用户可以给相同属性的一类资源打上相同的标签，便于管理。当前支持标签的资源有Device(设备)。 注意：iot_前缀的为系统预留标签，用户不能使用；一个资源最多只能打10个标签。 绑定标签 解绑标签 按标签查询资源 父主题： API
设备处理数据困难、设备间通信管理难等问题；而策略的使用可以解决该问题，因此建议最好与设备策略一同使用。 图1 业务流程图 M2M通信过程中通过Pub接口发的消息和Sub接口接收的消息会算入计费消息数，不产生其他额外费用。 当对设备topic的订阅与发布的权限有要求，或对细粒度控制
String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。
String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。
设备向平台上报数据，设备携带平台下发/19/0/0订阅时的token进行属性上报。 设备命令下发 API 说明 设备命令下发 物联网平台向设备下发命令，物联网平台通过LwM2M的/19/1/0资源对象将命令打包到LwM2M write消息的payload里下发给设备。 父主题： 设备侧LwM2M接口参考
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
