检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 设备鉴权 API 说明 设备鉴权 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token
网关与子设备 概述 物联网平台设备分为直连设备和非直连设备。 直连设备：通过平台支持的协议，直接连接到平台的设备称为直连设备。平台支持直连的协议请参考概述中类型为通用协议，子类型为直连云端中的协议。 非直连设备：针对未实现TCP/IP协议栈的设备，由于无法直接同物联网平台通信，它需要通过网关进行数据转发
网关与子设备管理 平台通知网关子设备新增 平台通知网关子设备删除 网关同步子设备列表 网关更新子设备状态 网关更新子设备状态响应 网关新增子设备请求 网关新增子设备请求响应 网关删除子设备请求 网关删除子设备请求响应 父主题： 设备侧MQTT/MQTTS接口参考
应用侧API参考 使用前必读 如何调用API API概览 API 权限与授权项 应用示例 附录
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 200 IOTDA.014111 Command request timed out.
修改设备网关 功能介绍 应用服务器可调用此接口在物联网平台修改子设备网关。 只允许子设备修改网关。 目标网关必须和当前设备在同一个资源空间。 网关id不能和当前子设备网关id相同。 设备如果有下级子设备，则不允许切换网关。 支持多级子设备，当前最大支持二级子设备。 该接口仅支持创建单个设备切换网关
网关同步子设备列表 功能介绍 网关设备从平台同步子设备列表。网关设备不在线时，平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时，可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过平台通知网关子设备新增接口通知网关设备，删除的子设备信息会通过平台通知网关子设备删除通知网关设备
网关新增子设备请求 功能介绍 网关主动新增其下接入的子设备，在平台上完成开户。网关与子设备关系，请查看网关与子设备。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
网关删除子设备请求 功能介绍 网关主动删除其下接入的子设备，在平台上完成销户。网关与子设备关系，请查看网关与子设备。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
平台通知网关子设备删除 功能介绍 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过
网关删除子设备请求响应 功能介绍 平台将该网关删除的子设备列表信息通知给网关设备。平台收到网关删除子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
网关更新子设备状态 功能介绍 网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看网关与子设备。 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。 该接口1次调用的tps为
网关新增子设备请求响应 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备，平台收到网关新增子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
如何调用API 构造请求 认证鉴权 返回结果 父主题： 应用侧API参考
IoT Device SDK介绍 为了帮助设备快速连接到物联网平台，华为提供了IoT Device SDK。支持TCP/IP协议栈的设备集成IoT Device SDK后，可以直接与物联网平台通信。不支持TCP/IP协议栈的设备，例如蓝牙设备、ZigBee设备等需要利用网关将设备数据转发给物联网平台
网关更新子设备状态响应 功能介绍 平台将该网关更新子设备状态结果以列表返回，平台收到网关更新子设备状态请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
删除设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台删除设备CA证书 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/certificates/{certificate_id} 表1 路径参数 参数 是否必选 参数类型 描述
华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、虚拟主机和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
