检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
远程配置 平台下发配置通知 设备上报配置响应 父主题： 设备侧MQTT/MQTTS接口参考
业务流程 设备远程配置流程详细说明： 用户在设备接入服务的控制台上创建远程配置任务。一个应用下最多同时运行10个远程配置任务，每个任务最多支持对10万个设备下发配置。如果一个设备已经在一个已有的远程配置任务中，并且该设备远程配置还未完成，新建的远程配置任务如果包含该设备，则该设备的新远程配置將直接失败。
进入网关切换页面。选择目标网关后，单击“确认”，完成当前设备的网关切换。 图4 设备信息-切换网关 批量修改子设备网关；在设备详情页单击“子设备”，进入子设备管理页面。选择您想要切换网关的子设备后，单击“切换网关”进入选择网关页面，选择目标网关后单击“确定”，完成网关的切换。 图5
修改设备网关 功能介绍 应用服务器可调用此接口在物联网平台修改子设备网关。 只允许子设备修改网关。 目标网关必须和当前设备在同一个资源空间。 网关id不能和当前子设备网关id相同。 设备如果有下级子设备，则不允许切换网关。 支持多级子设备，当前最大支持二级子设备。 该接口仅支持创
网关同步子设备列表 功能介绍 网关设备从平台同步子设备列表。网关设备不在线时，平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时，可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过平台通知网关子设备新增接口通知网关设备，删除的
平台下发配置通知 功能介绍 物联网平台向设备侧下发配置通知。物联网平台为用户提供远程配置功能，用户可以在不中断设备运行的情况下，远程更新设备的系统参数、运行参数等配置信息。例如：Windows的收银台机器，需要通过远程配置修改一些系统参数；车联网中的T-BOX，需要通过远程配置修改设备侧的一些数据上报频率等。
网关更新子设备状态 功能介绍 网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看网关与子设备。 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。 该接口1次调用的tps为1*上报子设备的数量。
网关新增子设备请求 功能介绍 网关主动新增其下接入的子设备，在平台上完成开户。网关与子设备关系，请查看网关与子设备。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
关闭设备隧道 功能介绍 应用服务器可通过该接口关闭某个设备隧道。关闭后可以再次连接。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/tunnels/{tunnel_id}
设备上报配置响应 功能介绍 设备上报配置结果响应。创建远程配置任务时，可以配置超时时间（1-30天，不配置默认30天）。在超时时间内，平台每24小时向设备下发一次配置，直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应，则平台显示该设备配置任务超时失败。 Topic 上行:
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
设备远程登录 物联网平台提供远程登录功能，支持通过控制台远程SSH登录设备，可在控制台输入设备支持的命令，进行功能调试及问题定位，从而方便地实现设备管理及远程运维。下面介绍远程登录的具体使用方法。 前提条件 设备使用的是linux操作系统； 设备上已安装SSH Server 应用；
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理 单账号调用该接口的
网关删除子设备请求 功能介绍 网关主动删除其下接入的子设备，在平台上完成销户。网关与子设备关系，请查看网关与子设备。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
用户可通过该接口查询某项目中的某个设备隧道，查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET /v5/iot/{p
网关更新子设备状态响应 功能介绍 平台将该网关更新子设备状态结果以列表返回，平台收到网关更新子设备状态请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
功能介绍 用户可通过该接口查询某项目下的所有设备隧道，以实现对设备管理。应用服务器可通过此接口向平台查询设备隧道建立的情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/tunnels
平台通知网关子设备删除 功能介绍 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
网关删除子设备请求响应 功能介绍 平台将该网关删除的子设备列表信息通知给网关设备。平台收到网关删除子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
