动态与公告

产品动态

产品简介

产品概述

产品功能

产品优势

应用场景

产品限制

基本概念

快速入门

快速开始

场景一：设备互通

场景二：设备状态上报与状态设置

MQTT.fx接入指南

控制台使用手册

产品管理

规则引擎

子账号访问IoT

固件升级

资源管理

证书管理

开发者手册

功能组件

签名方法

设备身份认证

设备接入协议

网关子设备

消息通信

设备影子

设备固件升级

设备远程配置

资源管理

设备日志上报

NTP服务

设备端接入手册

设备接入概述

基于C SDK接入

基于 Android SDK 接入

基于 Java SDK 接入

基于 Python SDK 接入

API 文档

History

Introduction

API Category

Making API Requests

Device Shadow APIs

Device APIs

CA Certificate APIs

Product APIs

Data Types

Error Codes

常见问题

一般性问题

设备接入和上报问题

规则引擎问题

控制台相关问题

IoT Hub 政策

隐私协议

数据处理和安全协议

词汇表

代理子设备上下线

PDF

聚焦模式

字号

最后更新时间： 2024-12-27 15:54:13

功能概述
网关类型的设备，可通过与云端的数据通信，代理其下的子设备进行上线与下线操作。此类功能所用到的 Topic 与网关子设备拓扑管理的 Topic 一致：
数据上行 Topic（用于发布）：$gateway/operation/${productid}/${devicename}
数据下行 Topic（用于订阅）：$gateway/operation/result/${productid}/${devicename}
代理子设备上线
网关类型的设备，可以通过数据上行 Topic 代理子设备上线。请求成功之后，云端通过数据下行 Topic 返回子设备的上线信息。
网关代理子设备上线请求数据格式：
{
  "type": "online",
  "payload": {
    "devices": [
      {
        "product_id": "CFCSQ5EAG7",
        "device_name": "onlinedev00"
      }
    ]
  }
}
代理子设备上线响应数据格式：
{
  "type": "online",
  "payload": {
    "devices": [
      {
        "product_id": "CFCSQ5EAG7",
        "device_name": "onlinedev00",
        "result":0
      }
    ]
  }
}
请求参数说明：
字段
类型
描述
type
String
网关消息类型。代理子设备上线取值为：online
payload.devices
Array
需上线的子设备列表
product_id
String
子设备产品 ID
device_name
String
子设备名称
响应参数说明：
字段
类型
描述
type
String
网关消息类型。代理子设备上线取值为：online
payload.devices
Array
需上线的子设备列表
product_id
String
子设备产品 ID
device_name
String
子设备名称
result
Int
子设备上线结果，具体错误码见下表
代理子设备下线
网关类型的设备， 可以通过数据上行 Topic 代理子设备下线。请求成功之后，云端通过数据下行 Topic 返回成功子设备的下线信息。
网关代理子设备下线请求数据格式：
{
  "type": "offline",
  "payload": {
    "devices": [
      {
        "product_id": "CFCSQ5EAG7",
        "device_name": "offlinedev00"
      }
    ]
  }
}
代理子设备下线响应数据格式：
{
  "type": "offline",
  "payload": {
    "devices": [
      {
        "product_id": "CFCSQ5EAG7",
        "device_name": "offlinedev00",
        "result":-1
      }
    ]
  }
}
请求参数说明：
字段
类型
描述
type
String
网关消息类型。代理子设备下线取值为：offline
payload.devices
Array
需代理下线的子设备列表
product_id
String
子设备产品 ID
device_name
String
子设备名称
响应参数说明：
字段
类型
描述
type
String
网关消息类型。代理子设备下线取值为：offline
payload.devices
Array
需代理下线的子设备列表
product_id
String
子设备产品 ID
device_name
String
子设备名称
result
Int
子设备下线结果，具体错误码见下表
错误码
错误码
描述
0
成功
-1
网关设备未绑定该子设备
-2
系统错误，子设备上线或者下线失败
801
请求参数错误
802
设备名非法，或者设备不存在
810
不支持的子设备

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

物联网通信

代理子设备上下线

功能概述

代理子设备上线

代理子设备下线

错误码

帮助和支持

字段	类型	描述
type	String	网关消息类型。代理子设备上线取值为：`online`
payload.devices	Array	需上线的子设备列表
product_id	String	子设备产品 ID
device_name	String	子设备名称

错误码	描述
0	成功
-1	网关设备未绑定该子设备
-2	系统错误，子设备上线或者下线失败
801	请求参数错误
802	设备名非法，或者设备不存在
810	不支持的子设备