查询、修改、删除设备影子 查询设备影子 方法1：应用服务器调用查询设备影子数据接口。 方法2：登录管理控制台，选择您的实例，单击实例卡片进入。在左侧导航栏选择“设备”，单击具体的设备进入到设备的详情页面，在“设备影子”页签中，可以查看当前设备属性数据，包括“上报值”和“期望值”。 如果当前界面中看到“上报值”与“期望值”不一致，原因可能是设备未在线，暂时存储在设备影子中，待同步给设备，期望值会存在深色底纹。 如果当前界面看到的“上报值”与“期望值”一致，则表示设备最近一次上报的属性值与用户期望下发的属性值一致，期望值为白色底纹。 图1 设备影子-查看 修改设备影子 方法1：应用服务器调用配置设备影子预期数据接口。 方法2：登录管理控制台，选择您的实例，单击实例卡片进入。在左侧导航栏选择“设备-所有设备”，在设备列表中单击具体的设备进入到设备的详情页面，在“设备影子”页面，单击“属性配置”，在弹出窗口中输入服务属性对应的期望值，单击"确定"完成设备影子的修改。 图2 设备影子-属性配置 删除设备影子 用户删除设备影子，平台将会将设备影子中的所有数据（包含上报值和期望值）清空。 图3 删除设备影子

业务流程 修改设备属性值 修改desired区属性值，如果设备在线，则设备影子直接同步设备属性值到设备，否则等待设备上线或上报数据时，再同步设备属性值到设备。 用户通过控制台或应用服务器修改设备属性值。消息样例如下： PUT https://{Endpoint}/v5/iot/{project_id}/devices/{device_id}/shadow Content-Type: application/json X-Auth-Token: ******** Instance-Id: ******** { "shadow" : [ { "desired" : { "temperature" : "60" }, "service_id" : "WaterMeter", "version" : 1 } ] } 物联网平台 修改desired区属性值。 物联网平台返回响应消息。 物联网平台判断设备上线或上报数据。 物联网平台将设备属性同步到设备。消息样例如下： Topic: $oc/devices/{device_id}/sys/properties/set/request_id={request_id} 数据格式： { "object_device_id": "{object_device_id} ", "services": [ { "service_id": "Temperature", "properties": { "value": 57, "value2": 60 } }, { "service_id": "Battery", "properties": { "level": 80, "level2": 90 } } ] } 设备返回响应消息。设备影子desired区的属性值发送给设备后，需要设备回响应表示已收到请求。消息样例如下： Topic：$oc/devices/{device_id}/sys/properties/set/response/request_id={request_id} 数据格式： { "result_code": 0, "result_desc": "success" } 7.设备上报数据，当设备进行属性上报时，平台会存储设备最新上报的设备属性值。 设备上报属性时，物联网平台修改设备影子reported区属性值为设备上报的设备属性值。消息样例如下： Topic: $oc/devices/{device_id}/sys/properties/report 数据格式： { "services": [ { "service_id": "Temperature", "properties": { "value": 57, "value2": 60 }, "event_time": "20151212T121212Z" }, { "service_id": "Battery", "properties": { "level": 80, "level2": 90 }, "event_time": "20151212T121212Z" } ] } 设备主动删除设备影子的reported区 设备主动删除reported区service下的单个属性 设备上报属性时，将属性设置为null，平台会将该属性从设备影子reported区删除，消息样例如下： Topic: $oc/devices/{device_id}/sys/properties/report { "services": [ { "service_id": "Temperature", "properties": { "value": null, "value2": 60 }, "event_time": "20151212T121212Z" } ] } 设备主动删除影子reported区的service下的全部的属性 设备上报属性时，将service对应的properties设置为{}时，平台会将reported区该service模块下所有属性从设备影子reported区删除，消息样例如下: Topic: $oc/devices/{device_id}/sys/properties/report { "services": [ { "service_id": "Temperature", "properties": {}, "event_time": "20151212T121212Z" } ] } 查询设备属性值 设备影子保存的是设备最新的设备属性值，一旦设备属性值产生变化，设备会将设备属性值同步到设备影子。用户便可以及时获取查询结果，无需关注设备是否在线。 用户通过控制台或应用服务器查询设备属性值。消息样例如下： GET https://{Endpoint}/v5/iot/{project_id}/devices/{device_id}/shadow Content-Type: application/json X-Auth-Token: ******** Instance-Id: ******** 物联网平台返回desired属性值和report属性值，即期望值和上报值。消息样例如下： Status Code: 200 OK Content-Type: application/json { "device_id" : "********", "shadow" : [ { "desired" : { "properties" : { "temperature" : "60" }, "event_time" : "20151212T121212Z" }, "service_id" : "WaterMeter", "reported" : { "properties" : { "temperature" : "60" }, "event_time" : "20151212T121212Z" }, "version" : 1 } ] }

操作场景 添加设备后，设备下的点位默认没有开通视频管理等服务，您可以按需选择并开通服务。提供的服务如下： 接入调阅服务：提供 视频接入 和管理功能，开通后可以查看实况和录像。使用录像存储服务，首先需要配置接入调阅服务。 录像存储服务：提供云端视频存储功能，开通后设置录像计划进行录像存储，关闭服务后会删除所有录像文件。 行业数据流服务：提供云端存储设备智能告警数据功能，开通后可以在云端保存设备智能告警数据，如智能告警图片、智能分析元数据等。关闭服务后会删除所有相关数据。

响应示例 状态码： 200 OK { "device_id": "952352LWXT***", "device_name": "测试设备", "device_state": "ONLINE", "access_protocol": "HOLO", "device_type": "IPC", "device_system_state": "NORMAL", "description": "test", "model": "JVS-N71-HD", "manufacture": "JOVISION", "channel_total": 10, "stream_total": 2, "firmware": "V1.0", "device_ability" : "ptz,talk", "device_cloud_ability": { "alarm_voice": { "support": "true" }}, "create_time": "2020-06-26 20:42:16", "update_time": "2020-06-26 20:42:16", "protocol_version": "2.0.0", "mac": "xxx", "device_ip": "xxx.xxx.xxx.xxx", "device_port": "8090", "device_org_id": "1234567890***", "device_org_name": "测试组织***", "operator_total": "2", "sdk_ability": "***", "sn": "952352LWXT***" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 Query参数 参数 是否必选 参数类型 描述 ability 否 Array of strings 查询的能力集列表：不传默认查询所有能力集，数组长度范围[0,10]。能力集对应能力参考设备能力集。 need_cloud_ability 否 Boolean 是否需要返回云上管理的能力集：false，不返回云上能力集信息；true，返回云上能力集信息。不填默认false need_specification 否 Boolean 是否需要能力规格：false，不返回能力规格；true，返回能力规格。不填默认false

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 mac String 设备mac地址 device_id String 设备ID，设备唯一标识符，如：2102412969WLMB002258 device_name String 设备名称 device_state String 设备状态 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 access_protocol String 接入类型 枚举值： GB28181 国标 HOLO 好望 device_type String 设备类型 枚举值： IPC 通用相机 NVR NVR设备 MEdge IVS1800设备 IPC-BULLET 枪机 IPC-BOX 筒机 IPC-CONCH 半球/海螺 IPDOME 球机 device_system_state String 设备系统冻结 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 description String 设备描述 model String 设备型号，如：D2150 manufacture String 生产厂商，如：HUAWEI channel_total Integer 通道总数 stream_total Integer 每个通道码流数量 firmware String 摄像头固件版本号 device_ability String 设备能力集：枚举类型，参考附录设备能力集，多个能力集用逗号分隔 device_cloud_ability Object 云端能力集规格 create_time String 创建时间 update_time String 更新时间，在设备重新上线后或者移动设备分组后会修改时间 protocol_version String 设备与平台接入协议版本，如：2.0.0 device_ip String 设备IP device_port String 设备端口 device_org_id String 设备组织ID sn String SN号，等于device_id——设备ID，设备唯一标识符 device_org_name String 设备所处的设备组织名称 operator_total String 操作员总数 sdk_ability String sdk能力集

URI GET /v1/{user_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR)，用来区分设备类型 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

设备孪生（DeviceTwin） 终端设备通常包含两类数据： 一是不会改变的元数据，包括序列号、资产标识符、Mac地址等描述设备信息的数据。这种数据也可以称为终端设备的静态属性或设备属性。 另一类是终端设备的动态数据，包括特定背景下的终端设备专有实时数据，例如灯的开、关状态。这种数据也可以称为终端设备的孪生属性。 设备孪生具有与物理设备相同的特性，便于终端设备与应用之间进行更好地通信。应用发送的命令首先到达设备孪生，设备孪生根据应用设置的Expected State（期望的状态）进行状态更新，此外终端设备实时反馈自身的Actual State（真实的状态），设备孪生同时记录终端设备的Actual State和Expected State 。这种方式也使终端设备在离线状况下再次上线时，终端设备的状态也能得到同步。 图2 DeviceTwin 在IEF中可以创建终端设备，并能将终端设备与边缘节点关联，关联后会在边缘节点上保存被关联设备的属性和孪生信息。边缘节点上的应用程序可在边缘节点获取终端设备属性、设备孪生信息、以及修改终端设备孪生期望值和真实值。同时IEF负责同步云、边的孪生信息，当有冲突时，将以边缘侧的修改为主。 详细的终端设备状态边云协同机制请参见设备孪生工作原理。

边缘节点和子设备均在线，为什么子设备上报的数据在IoTDA平台查看不到？ 查看EdgeHub日志（专业版节点日志路径：/var/IoTEdge/log/sys_edge_hub/log/edge-hub-running.log；专业版节点日志路径：/var/IEF/app/log/sys_edge_hub/log/edge-hub-running.log），触发子设备数据上报时，查看日志内容是否有异常信息。 若日志提示“No services”，为该设备上报的数据与设备产品的serviceId对应不上。当前边缘节点不感知产品的更新。若新建一个空白的设备产品，为边缘节点创建子设备，然后修改设备产品新增服务和属性，则此时设备上报数据中的服务属性在边缘节点无感知，即会出现“No services”的异常。 当进行基于IoT边缘实现模拟MQTT设备的快速接入实践，添加边缘设备时，误操作填写了模块ID后，导致数据无法上报，删除边缘设备后重新添加。模块ID的设置代表设备接入点为该模块；空代表设备接入点为设备自身，相当于网关。 父主题： 子设备管理

设备列表支持的操作 添加设备。 手动添加设备： 单击设备列表右上方“手动添加”，进入添加设备页面。 选择设备所属站点。 如果不选站点，网络设备添加到平台后，不归属任何站点，安全设备（防火墙）添加到平台后，会自动归属默认站点（系统自行创建，一般以default-site加上uuid的前8位命名）。 在“待添加设备列表”区域单击“添加”，支持按设备SN或设备类型方式添加设备。 按SN添加：输入相应的设备序列号，单击“确定”。 单个SN长度在10-40位之间，只允许包含数字和字母。 如果按SN方式添加失败，请使用设备类型方式添加设备。 如果设备SN被占用，导致无法添加设备，请在右上角的帐号下，单击“我的工单”，提交工单寻求解决方法。或者联系MSP清除设备SN。 （推荐）按设备类型添加：选择设备类型（AP/WAC/交换机/AR/防火墙）、设备款型、设备数量，单击“确定”。 （可选）补充和完善设备信息。 如果添加的设备涉及防火墙/交换机，请务必执行本步骤，否则会影响后续网络操作。 防火墙的SN信息不能为空，需要您手动输入。 AR设备角色默认为“出口网关”，如不符合实际情况，请手动修改角色（出口网关/网关+路由反射器）。 交换机角色默认是“接入交换机”，如果不符合实际情况，请手动修改角色（汇聚/核心/接入）。 安全设备（防火墙）： 选择目标设备，单击按钮，设备SN信息为必填项，其余参数参考表 安全设备参数说明设置，完成后单击“确定”。 表3 安全设备参数说明 参数 参数说明 设备名称 设备名称仅包含字母、数字、中文和特殊符号（不含空格）。 SN 设备序列号，是设备的唯一识别码，必填参数。 设备款型 当前支持“云管模式”的防火墙型号有：USG6106E、USG6305E、USG6306E、USG6308E、USG6312E、USG6322E、USG6332E、USG6350E、USG6305E、USG6309E、USG6315E、USG6325E、USG6335E、USG6355E、USG6365E、USG6385E、USG6395E、USG6525E、USG6515E、USG6550E、USG6560E、USG6580E、USG6555E、USG6565E、USG6575E-B、USG6585E、USG6605E-B。 防护网段 可配置防护网段及范围，用回车分隔。示例： 10.0.0.0/11 10.0.0.0-10.31.255.255。 高级设置（可选） 只有支持“云管模式”的防火墙款型才会显示此功能，具体款型清单参考本表“设备款型”参数说明。 传统模式：用户需要登录设备进行网络配置。 云管模式：用户可以在平台进行网络配置，且配置自动下发到设备。 说明： 请确保平台侧工作模式与设备实际配置的工作模式一致，否则会导致设备或网络异常。 如需将“传统模式”（防火墙设备出厂时默认“传统模式”）切为“云管模式”并成功被华为乾坤云平台纳管，具体请参见配置防火墙上线。 如需将“云管模式”切为“传统模式”，目前仅支持通过命令行操作。通过Console方式登录防火墙设备，在系统视图下执行命令： 查看当前防火墙工作模式：display firewall run-mode。 切为传统模式：undo firewall run-mode cloud-manage。 网络设备（AR/交换机/AP/WAC）： 选择目标设备（以交换机为例），单击按钮，设置SN、角色等信息，完成后单击“确定”。建议输入网络设备SN信息，方便后续设备上线。 确认设备信息无误后，最后单击“确认”。 批量导入（仅网络设备支持）： 单击“批量导入”，下载模板并填写好设备信息，然后导入即可。注意，导入的设备条数不超过1000条。 查看设备详情。 不同设备类型展示的信息不同，此处以“AP设备”为例。 单击指定的AP设备名称，进入AP设备详情页面，详细介绍如表4所示。 表4 设备详情介绍表 模块 说明 设备概览 设备信息概览：显示了设备名称、版本、补丁版本、型号、SN等信息。 配置锁定/解锁（仅网络设备支持）： 当设备处于正常状态，可以配置锁定，一旦锁定后新策略将无法下发到设备上；当设备处于“锁定”状态，可以配置解锁，重新下发策略。 远程登录：单击“远程登录”可直接跳转设备网管界面，支持查看设备信息、配置设备业务等。 说明： 只有设备已上线，设备状态处于正常或告警，才能使用远程登录功能。 目前只有AR、防火墙、WAC和部分交换机款型支持远程登录。 命令行（仅防火墙支持）：单击“命令行”可直接跳转设备CLI界面，支持查看设备信息、配置设备业务等。 说明： 只有防火墙设备处于正常或告警状态，并在站点配置界面手动修改accampus密码之后，才能使用命令行功能。修改accampus密码操作请参见修改密码。 基本信息（仅网络设备支持） 不同设备类型对应的基本信息不同。 AP：显示了设备接口、SSID、漫游邻居信息。 交换机：显示了接口信息，如接口名称、类型、运行状态、管理状态等。 WAC：显示了与WAC关联的AP列表信息，如AP的SN、型号、状态等。若关联的 Fit AP设备存在异常，可选择异常设备，单击AP列表右上方“修复”。 AR：显示了物理接口、报文速率等信息。 射频（仅AP支持） 射频：显示了频段、信道、频宽、功率、噪声强度等信息。 报文信息：显示了报文速率和报文统计信息。 资源 说明： 若设备未加入站点，将不会产生资源数据。 不同设备类型对应的资源信息不同，默认是最近24小时内的资源使用信息，可自定义时间段。 AP：显示了某一段时间内CPU使用率、内存使用率、网络速率和连接终端数。 交换机：显示了某一段时间内CPU使用率、内存使用率、存储空间使用率和温度。 WAC：显示了某一段时间内CPU使用率、内存使用率和网络速率。 AR：显示了某一段时间内CPU使用率、内存使用率和存储空间使用率。 防火墙：显示了某一段时间内CPU使用率、内存使用率、接口出口和接口入口速率等信息。 用户列表（仅AP支持）：支持通过终端MAC和终端IP查询用户，列表显示了名称、终端MAC、终端IP、SSID、无线信号强度、重传率、丢包率、信噪比等信息。 性能监控（仅AP、WAC、AR和LSW支持） AP支持查看下列指标： 指标概览 AP的性能指标概览信息，包括当前时间窗内此AP上总接入用户数、接入过程中各阶段失败次数等。单击各阶段失败次数，可跳转至接入分析页面查看该AP接入趋势。 问题分布 环形图直观展示了此AP上发生的所有问题的分布情况。 设备指标趋势 单击“查看趋势”，在“设备”页签，可查看设备的各性能指标趋势。 射频指标趋势 单击“查看趋势”，在“射频”页签，可分别查看不同频段射频的各性能指标趋势。 用户指标趋势 单击“查看趋势”，在“用户”页签，可分别查看不同频段射频用户的各性能指标趋势。 VAP指标趋势 单击“查看趋势”，在“VAP”页签，可查看VAP的各性能指标趋势。 QoS队列指标趋势 单击“查看趋势”，在“QoS队列”页签，可查看QoS队列的各性能指标统计和趋势。 AP健康度 单击“查看指标”，查看各时间段内此AP在不同频段上的各项性能指标数据，包括设备指标、射频指标、用户指标、VAP指标和QoS队列指标。鼠标悬停在在线用户数、信道利用率、干扰率等指标上时，会显示该指标的好、中、差阈值范围。如果指标数值属于中阈值范围时，该数值会被标为橙色；如果指标数值属于差阈值范围时，该数值会被标为红色。 关键事件 以小时为单位，展现每小时内此AP的基础指标概览信息（包括接入用户数、接入过程中各阶段失败次数等）以及关键事件（包括AP离线、关联失败、功率变化等）。单击各阶段失败次数，可跳转至接入分析页面查看该AP接入趋势。 关键事件红色标注时属于紧急事件；橙色标注时属于重要事件；黄色标注时属于一般事件。 时间节点为红色表示该节点下存在紧急事件；橙色表示该节点下存在重要事件；黄色表示该节点下存在一般事件；绿色表示该节点正常，无事件发生。 LSW支持查看设备指标、单板指标、接口指标及光模块指标。在下拉框中选择具体的指标名称，可查看指标数据，单击支持查看指标趋势。 WAC、AR支持查看设备指标、单板指标及接口指标。在下拉框中选择具体的指标名称，可查看指标数据，单击支持查看指标趋势。 故障告警 支持查看告警级别、名称、发生时间和告警内容等信息，告警级别如表 设备告警级别所示。 查看告警详情（仅网络设备支持）：在故障告警列表单击按钮，查看告警内容、来源、类型、定位信息等，以便后续定位和解决故障告警。 单个清除：对于网络设备告警，在故障告警列表单击或者勾选目标告警单击列表右上角“清除”。 对于安全设备告警，在故障告警列表点击“清除告警”或者勾选目标告警单击列表右上角“清除”。 批量清除：勾选目标告警，单击列表右上角“清除”。 全部清除：单击列表右上角“全部清除”。 说明： 若告警未经过处理就被清除，则该告警信息会再次上报。 任何级别的告警均可以清除。 设备告警清除，约3分钟后，工作台首页智慧体网络评分会变高，首页智慧体告警链接也会消失。 在设备在线状态不变的情况下，若清除离线告警信息，则首页智慧体不会再展示该离线告警。其他类型告警清除后若再次上报，则智慧体会再次展示该告警。 表5 设备告警级别 级别 说明 处理策略 紧急 已经影响业务，需要立即采取纠正措施。 需要紧急处理，否则有业务中断或系统瘫痪的风险。 重要 已经影响业务，如果不及时处理会产生较为严重后果。 需要及时处理，否则会影响重要业务运行。 次要 目前对业务影响轻微，但需要采取纠正措施，以防止更为严重的故障发生。 需要查找告警原因，消除故障隐患。 提示 检测到潜在的或即将发生的影响业务的故障，但是目前对业务还没有影响。 可根据告警了解网络和网元的运行状态，视具体情况进行处理。 搜索设备：在设备列表左上方输入设备SN或者设备名称，单击图标或回车键进行搜索。 删除设备：设备一旦删除，将无法处置设备上的事件，请谨慎操作。 单个删除：选择目标设备，单击列表中“删除”。 批量删除：选择想要删除的设备，单击列表右上方“删除”。 编辑设备信息：选择目标设备，单击列表中“编辑”，修改设备名称、SN、角色等信息。 切换站点：在设备列表中勾选目标设备，单击“站点切换”，选择新站点，然后单击“确定”。 站点切换操作会对业务产生重大的影响，且耗时较长，请谨慎操作。 设备从旧站点切换新站点后，系统将强制清除原有配置，按新站点业务配置重新下发。 对于AP设备，系统将强制清除原来所有的设备级配置（如子网，接口等配置）；对于非AP设备，可以选择是否清除原来的设备级配置；对于CoAP协议纳管的设备（如交换机S210系列）不支持配置清除。 设备如果重启上线，会将站点业务配置重新全量下发（CoAP协议纳管的设备重启不下发全量配置，如交换机S210系列）。 升级设备（仅防火墙支持）：只有工作在“传统模式”下的防火墙支持该操作。单击列表右上方“升级”，单击“新增”选择目标设备，最后选择升级类型，单击“确定”即可。 绑定热备（仅防火墙支持）：选择目标设备，单击列表中“绑定热备”，在弹框中选择需要绑定的设备，单击“确定”即可。 “绑定热备”是将两个安全设备绑定，实现主备设备间会话的同步备份。 当设备A发生故障时，通过将流量引导至设备B，可以保证业务持续不中断。 绑定热备操作的前提是设备均已成功上线。 目前支持热备操作的设备有：USG6106E，USG6301E-C，USG6302E-C，USG6303E-C，USG6305E，USG6306E，USG6308E，USG6308E-B，USG6309E，USG6312E，USG6315E，USG6318E-B，USG6322E，USG6325E，USG6332E，USG6335E，USG6338E-B，USG6350E，USG6355E，USG6358E-B，USG6365E，USG6378E-B，USG6385E，USG6388E-B，USG6395E，USG6398E-B，USG6501E-C，USG6502E-C，USG6503E-C，USG6515E，USG6520E-K，USG6525E，USG6550E，USG6555E，USG6560E，USG6560E-K，USG6565E，USG6575E-B，USG6580E，USG6585E，USG6590E-K，USG6603F-C，USG6605E-B，USG6000F-E01，USG6000F-E03，USG6000F-E05，USG6000F-E07，USG6000F-E09，USG6000F-E12，USG6000F-E15，USG6000F-E20，USG6303E。

设备页面介绍 表1 设备页面介绍 序号 模块名 模块说明 1 站点列表 快速搜索站点：输入站点名，单击或按回车键搜索符合条件的站点。 筛选站点设备：选中目标站点，设备概览和设备列表模块会同步显示该站点下所有设备信息。 2 设备概览 选择设备类型卡片，设备列表会显示所有同类型的设备信息。 3 设备列表 显示了设备名称、状态、款型、版本以及所属站点等信息，设备状态可参见表2 设备状态说明，而设备列表支持的操作请参见设备列表支持的操作。 表2 设备状态说明 设备状态 状态说明 可能原因 正常 设备成功上线 不涉及。 离线 设备离线 可能是网络连通性异常、设备配置丢失等。 未注册 设备上线失败 可能是证书到期、设备与华为乾坤云平台网络、设备版本不适配、设备款型不配套、注册服务未启动、网络IP地址冲突不通等。 设备已失效 当前设备没有版本信息。需要删除设备重新添加。 告警 在正常上线后的使用过程中出现告警 可能是设备配置下发失败、CPU占用高、内存高、光模块非标、有风暴等。

业务流程 IoT Device SDK提供相关的接口，开发者调用这些接口网关实现与物联网平台的对接。不同语言的SDK的接口名称不一样，每个接口功能请参见IoT Device SDK使用指南（Java）、IoT Device SDK使用指南（C）、IoT Device SDK使用指南（C#）、IoT Device SDK使用指南（Android）、IoT Device SDK Tiny使用指南（C）。 表1 业务流程 应用侧管理子设备业务流程 网关管理子设备业务流程 图2 应用侧管理子设备流程图 图3 网关侧管理子设备流程图 1.在物联网平台上传网关的产品模型，并注册网关设备。 2.网关调用鉴权接口上线 3.在物联网平台上传子设备的产品模型。 4.网关鉴权成功后，应用调用添加子设备接口，填写设备相关信息（与产品模型定义一致）。添加成功后，您可以在物联网平台查看添加的子设备（如何查看？）。您也可以通过控制台添加子设备，详细请查看如何添加？ 4.网关鉴权成功后，网关调用网关新增子设备请求接口，填写设备相关信息（与产品模型定义一致）。平台在处理完成后，将处理结果通过接口网关新增子设备请求响应发送给网关。 5.添加子设备后，子设备状态显示“未激活”。请在子设备添加成功后，或者子设备上报数据前，调用网关更新子设备状态接口进行设备状态更新。 说明： 子设备的状态表示子设备接入网关的状态，由网关上报到物联网平台进行状态的刷新；如果网关不能正常上报子设备的状态信息到物联网平台，则展示的子设备状态不会刷新。例如：某子设备通过网关接入到物联网平台，子设备状态为在线状态，如果此时网关与物联网平台断开连接，则网关不能上报子设备的状态到物联网平台，该子设备的状态会一直显示在线。 6.网关调用批量属性上报接口上报子设备的数据，接口里的参数填写网关和子设备的相关设备信息。 7.网关订阅命令下发Topic，接收并处理应用服务器或物联网平台下发的命令。 8.应用服务器调用删除设备接口，给网关下发删除子设备命令，网关收到该命令后，可以进行相应的业务处理。 8.网关调用网关删除子设备请求接口，平台收到后会进行数据处理，当处理完成后会通过接口网关删除子设备请求响应将结果发送给设备。

概述 物联网平台设备分为直连设备和非直连设备。 直连设备：通过平台支持的协议，直接连接到平台的设备称为直连设备。平台支持直连的协议请参考概述中类型为通用协议，子类型为直连云端中的协议。 非直连设备：针对未实现TCP/IP协议栈的设备，由于无法直接同物联网平台通信，它需要通过网关进行数据转发。网关设备为直连设备，当前仅支持通过mqtt协议直连到平台的设备作为网关设备。 直连设备与非直连设备关系如下图： 图1 网关与子设备

迁移前提 1、已开通IoTDA基础版，并购买了IoTDA企业版/标准版。 2、用户的应用平台访问IoTDA的地址可以修改，应用平台访问IoTDA从基础版地址改成企业版实例的地址。 3、用户的设备访问IoTDA的地址可以修改，设备访问IoTDA从基础版地址改成企业版实例的地址。如果设备访问IoTDA的地址不能修改(例如设备不支持固件升级)，可以提交工单说明您的诉求。 设备数据迁移时，如果是指定资源空间和设备迁移，迁移数据仅包括设备连接新实例认证需要的身份信息，包括资源空间、产品、证书、设备基本信息和设备状态；暂不包括基础版中的设备分组、服务端订阅、规则引擎和运行日志配置。

响应示例 { "status" : 1, "message" : "SUC CES S", "error" : null, "data" : { "data" : [ { "streamTotal" : 0, "firmware" : null, "deviceAbility" : "intelligent", "mac" : null, "createTime" : null, "updateTime" : null, "protocolVersion" : null, "deviceIp" : null, "devicePort" : null, "tenantId" : 1, "createdBy" : 101482, "creationDate" : 1616570870000, "lastUpdatedBy" : -1, "lastUpdateDate" : 1627452138000, "fileId" : null, "fileExt" : null, "fileName" : null, "fileSize" : null, "sysType" : null, "webPlayUrl" : null, "isdpDeviceId" : "2102412462WLL4003540-0", "deviceAlarmStatus" : "pulse", "deviceSubType" : "IPC-BOX", "deviceManageState" : "ACTIVATION", "deleteFlag" : "0", "autoJoin" : null, "battery" : null, "longitude" : null, "coordType" : null, "chatJid" : null, "liveChannelId" : null, "create_state" : null, "chatId" : null, "deviceUserId" : null, "buOrgId" : 503, "buOrgName" : "XXXX公司", "appName" : "holosens-server", "entityName" : "device", "deviceGbUsername" : null, "deviceGbPassword" : null, "ownnerName" : null, "deviceUserName" : null, "storageRemain" : null, "customerOrgCode" : null, "customerOrgName" : null } ], "pos" : 0, "total_count" : 1, "entityName" : null }, "timestamp" : "2021-07-28T14:04:20.909+0800" }