设备查询 地图上可查看已接入的设备。 通过筛选设备类型，在地图上高亮同类型的所有设备。 通过输入设备Id或esn，在地图上高亮显示相应的设备。 在线率统计：各个设备类型的统计原理详见表1。 表1 设备在线率统计 统计对象 统计原理 边缘Edge 在线率=设备在线数 / 边缘Edge设备总数 在线：该边缘Edge和 路网数字化服务 连接正常 运行中：该边缘Edge节点在IEF（华为云智能边缘平台）状态为运行中，即Atlas设备和IEF当前连接正常 待部署：该边缘Edge节点在IEF状态为待部署，即Atlas设备还未部署 部署中：该边缘Edge节点在IEF状态为部署中，即Atlas设备正在部署 离线：该边缘Edge和路网数字化服务连接断开 升级中：该边缘Edge节点在IEF状态为升级中，即Atlas设备正在升级 删除中：该边缘Edge节点在IEF状态为删除中，即Atlas设备正在删除 未接入：该边缘Edge设备信息导入后，和路网数字化服务从未建立过连接 路侧RSU 在线率=设备在线数 / RSU设备总数 在线：该RSU和路网数字化服务连接正常 离线：该RSU和路网数字化服务连接断开 未接入：该RSU设备信息导入后，RSU设备和路网数字化服务从未建立过连接 摄像头 在线率=设备在线数 / 摄像头设备总数 在线：该摄像头和路网数字化服务连接正常 离线：该摄像头和路网数字化服务连接断开 未接入：该摄像头设备信息导入后，和路网数字化服务从未建立过连接 雷达 在线率=设备在线数 / 雷达设备总数 在线：该雷达和路网数字化服务连接正常 离线：该雷达和路网数字化服务连接断开 未接入：该雷达设备信息导入后，和路网数字化服务从未建立过连接 设备删除：单击“删除”按钮，可以删除该设备信息。 设备详情：单击“详情”按钮，可以查看该设备的详细信息。 设备修改：单击“编辑”按钮，可以修改该设备信息。 父主题： 设备管理

设备列表支持的操作 添加设备。 手动添加设备： 单击设备列表右上方“手动添加”，进入添加设备页面。 选择设备所属站点。 如果不选站点，网络设备添加到平台后，不归属任何站点，安全设备（防火墙）添加到平台后，会自动归属默认站点（系统自行创建，一般以default-site加上uuid的前8位命名）。 在“待添加设备列表”区域单击“添加”，支持按设备SN或设备类型方式添加设备。 按SN添加：输入相应的设备序列号，单击“确定”。 单个SN长度在10-40位之间，只允许包含数字和字母。 如果按SN方式添加失败，请使用设备类型方式添加设备。 如果设备SN被占用，导致无法添加设备，请在右上角的帐号下，单击“我的工单”，提交工单寻求解决方法。或者联系MSP清除设备SN。 （推荐）按设备类型添加：选择设备类型（AP/WAC/交换机/AR/防火墙）、设备款型、设备数量，单击“确定”。 （可选）补充和完善设备信息。 如果添加的设备涉及防火墙/交换机，请务必执行本步骤，否则会影响后续网络操作。 防火墙的SN信息不能为空，需要您手动输入。 AR设备角色默认为“出口网关”，如不符合实际情况，请手动修改角色（出口网关/网关+路由反射器）。 交换机角色默认是“接入交换机”，如果不符合实际情况，请手动修改角色（汇聚/核心/接入）。 安全设备（防火墙）： 选择目标设备，单击按钮，设备SN信息为必填项，其余参数参考表3设置，完成后单击“确定”。 表3 安全设备参数说明 参数 参数说明 设备名称 设备名称仅包含字母、数字、中文和特殊符号（不含空格）。 SN 设备序列号，是设备的唯一识别码，必填参数。 设备款型 当前支持“云管模式”的防火墙型号请参见《华为乾坤云管理网络配套款型表》（若无权限访问，请联系华为渠道获取）中的相关内容。 防护网段 可配置防护网段及范围，用回车分隔。示例： 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支持查看设备指标、单板指标及接口指标。在下拉框中选择具体的指标名称，可查看指标数据，单击支持查看指标趋势。 故障告警 支持查看告警级别、名称、发生时间和告警内容等信息，告警级别如表5所示。 查看告警详情（仅网络设备支持）：在故障告警列表单击按钮，查看告警内容、来源、类型、定位信息等，以便后续定位和解决故障告警。 单个清除：对于网络设备告警，在故障告警列表单击或者勾选目标告警单击列表右上角“清除”。 对于安全设备告警，在故障告警列表点击“清除告警”或者勾选目标告警单击列表右上角“清除”。 批量清除：勾选目标告警，单击列表右上角“清除”。 全部清除：单击列表右上角“全部清除”。 说明： 若告警未经过处理就被清除，则该告警信息会再次上报。 任何级别的告警均可以清除。 设备告警清除，约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占用高、内存高、光模块非标、有风暴等。

动态群组场景示例 通过设备名称模糊匹配规则（其他条件可以根据实际场景选择）创建动态群组，选择该动态群组执行OTA升级任务。 动态群组中的设备会动态根据设备名称匹配情况进行调整，并且该动态群组关联的OTA升级任务详情状态也会随之动态变化。 具体参考批量设备固件升级和动态群组的相关步骤进行操作。 创建动态群组，群组名称为“HuaweiDeviceGroup”，群组规则为 “device_name like 'HuaweiDevice%'”。 图6 动态群组-详情 创建设备固件升级任务，选择动态群组“HuaweiDeviceGroup”，完成任务创建。 图7 新建固件升级任务-动态群组 创建成功后可以查看动态群组中的设备已加入到该升级任务中。 图8 固件升级任务-详情(动态群组) 参考注册单个设备注册设备，设备名称为“HuaweiDevice011”。注册成功后可以查看该设备已自动加入“HuaweiDeviceGroup”动态群组中。 图9 动态群组-添加设备 查看软固件升级任务子任务详情，可以看到此设备已自动加入到升级任务中： 图10 固件升级任务-动态群组添加新设备 进入“HuaweiDevice001”设备详情界面，修改名称为“AbandonedHuaweiDevice001”。 图11 设备-设备名称修改 修改设备名称成功后，可以查看该设备已自动从“HuaweiDeviceGroup”动态群组中移除。 图12 动态群组-移除设备 查看软固件升级任务子任务详情，可以看到此设备的升级状态为“已移除”。 图13 固件升级任务-动态群组移除设备

群组概述 群组是一系列设备的集合，用户可以对资源空间下所有设备，根据区域、类型等不同规则进行分类建立群组，以便处理对海量设备的批量操作。例如，对资源空间下所有水表设备的群组进行固件升级。平台支持群组的增删改查操作，支持给群组绑定和解绑设备，支持一个设备被添加到多个群组中。 表1 群组分类 群组类型 使用说明 静态群组 手动添加设备到群组以及从群组中移除设备；支持群组层级嵌套。 限制： 账号下单实例最多可创建1,000个群组（包含嵌套的子群组）。 一个群组内最多添加20,000个设备。 一个设备最多可以被添加到10个群组中。 群组嵌套关系最大5级。 子群组只能归属一个父群组，不支持多父群组。 当群组有子群组时不能直接删除，需要先删除子群组才能删除父群组。 动态群组 按照动态群组规则(设备查询条件，类SQL语句)动态的将符合条件的设备自动添加进群组，不符合条件的自动移除群组；不支持手动管理群组中的设备。 限制： 账号下单实例最大可创建10个动态群组。 首次创建动态群组，规则最多允许匹配的100,000个设备(增量加入群组的设备无限制)。 动态群组默认为父群组，不支持将动态群组进行嵌套。 动态群组创建成功后，不允许修改动态群组规则。 不允许手动管理动态群组中的设备。 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 单账号创建动态群组的 TPS 限制最大为1/S(每秒1次请求数)。

相关操作 禁用策略：下发成功的策略可以在“操作”列单击“禁用”，禁用此条策略，单击“禁用”后此条策略的“状态”显示为“禁用（下发中）”，当策略的“状态”变为“禁用（下发成功）”此条策略被禁用。 删除策略：下发成功的策略可以在“操作”列单击“删除”，删除此条策略，单击“删除”后界面右上角提示该条策略删除成功。 数据库加密后不允许禁用和删除，只能通过下发解密策略进行抵消。 编辑操作：数据库加密策略不允许编辑，只有动态脱敏策略可以编辑。

支持的监控指标 VR云渲游平台采集并展示关键的应用体验指标，各项指标的具体含义如表2所示。您可以根据各项监控指标，实时掌握该设备连接的环境质量，了解用户的应用体验。 表2 VR云渲游平台监控指标支持列表 中文名称 英文名称 指标含义 物理MTP时延(ms) PhysicalLatency(ms) 输入动作（头部转动或控制器操作等）与屏幕更新显示（从刷新的屏幕发出的光线）内容之间的时延，单位为ms 用户感知时延（ms） PerceptionLatency(ms) 物理MTP时延 - 动作预测时间 动作预测时间（ms） PredictionInterval(ms) 一帧动作预测的显示时间 - 获取动作当前的时间 上行动作传输时延(ms) TrackInfoTransLatency(ms) 客户端传输动作信息到服务器接收到所消耗的时延 游戏渲染时延(ms) GameRenderLatency (ms) 游戏应用完成一帧画面渲染所消耗的时延 编码前准备资源时延（ms） PrepareResourceLatency (ms) 编码前为一帧画面完成准备资源所消耗的时延 编码时延(ms) EncodeLatency (ms) 完成一帧画面编码所消耗的时延所消耗 FEC编码时延(ms) FecEncodeLatency (ms) 对一帧画面完成FEC编码所消耗的时延 下行帧传输时延(ms) FrameTransLatency(ms) 一帧画面从服务器传输到客户端所消耗的时延 解码时延(ms) DecodeLatency (ms) 客户端解码所消耗的时延 客户端渲染时延(ms) ClientRenderLatency(ms) 客户端完成一帧画面的渲染时延 黑边度数（度数） ErrorInDegree(Degree) 横向视场角(FOV)上的黑边角度(Yaw) 每秒丢包数 PacketsLostInSecond (Packets/s) 画面内容从服务器传输到客户端过程中的丢包率 网络RTT(ms) NetworkRTT (ms) 客户端到服务器之间的网络端到端时延 服务器接收速率(kbps) RecvRate (Mbps) 服务器接收速率(kbps) 服务器发送速率(kbps) SentRate (Mbps) 服务器发送速率(kbps) 客户端接收速率(kbps) ClientRecvRate (Mbps) 客户端接收速率(kbps) 客户端发送速率(kbps) ClientSentRate (Mbps) 客户端发送速率(kbps) 编码算法 TargetCodec 编码算法，表示是264还是265 分辨率 TargetResolution(px * px) 目标分辨率 编码器参数 TargetEncoderConfig 编码器参数 图像帧率 RenderFps 头盔图像帧率

响应示例 状态码： 200 OK [ ] 状态码： 400 Bad Request { "error_code" : "SCB.00000000", "error_msg" : "Parameter is not valid for operation [romalink.link-device.getDeviceShadow]. Parameter is [deviceOid]. Processor is [path].", "request_id" : "cb39e78a-afd3-4e04-901d-70468b1c23dc-1619602712496-cnnorth7a-P-romalink-service01" } 状态码： 404 Not Found { "error_code" : "SCB.00000000", "error_msg" : "Not Found", "request_id" : "624c8be1-39b6-47b7-941d-c159aced368a-1619602544650-cnnorth7a-P-romalink-service01" } 状态码： 500 Internal Server Error { "error_code" : "ROMA.00110002", "error_msg" : "The instance does not exist. project_id: 397cd10b30544c588b2f4a56d83856c4, instance_id: f3bb386a-23ec-47aa-9943-4c60ac658611", "request_id" : "c8c06d0a-be92-4fdf-9d10-bc20131ab158-1619593104919-cnnorth7a-P-romalink-service01" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of ShadowService objects OK 表4 ShadowService 参数 参数类型 描述 service_id Integer 服务ID。 最小值：1 最大值：99999999999999999 service_name String 服务名称。 最小长度：2 最大长度：64 properties Array of ShadowValue objects 影子值。 数组长度：1 - 9999 表5 ShadowValue 参数 参数类型 描述 property_name String 属性名称。 最小长度：0 最大长度：64 property_value String 属性最后一次上报值。 最小长度：0 最大长度：64 property_updated_date Long 属性最后一次上报时间，格式timestamp(ms)，使用UTC时区。 最小值：1 最大值：99999999999999999 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 系统错误码，针对4xx和5xx类HTTP错误码的详细错误码。 最小长度：0 最大长度：64 error_msg String 错误描述。 最小长度：0 最大长度：200 request_id String 消息ID。 最小长度：0 最大长度：64 状态码： 404 表7 响应Body参数 参数 参数类型 描述 error_code String 系统错误码，针对4xx和5xx类HTTP错误码的详细错误码。 最小长度：0 最大长度：64 error_msg String 错误描述。 最小长度：0 最大长度：200 request_id String 消息ID。 最小长度：0 最大长度：64 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 系统错误码，针对4xx和5xx类HTTP错误码的详细错误码。 最小长度：0 最大长度：64 error_msg String 错误描述。 最小长度：0 最大长度：200 request_id String 消息ID。 最小长度：0 最大长度：64

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

开发前必读 设备管理功能主要是通过操作两个标准页面（编辑设备、设备管理），来实现电梯设备信息的新增、修改、删除、查询及监控等功能的。 设备管理界面的大致构想，如图1所示。界面上默认显示应用中保存的所有电梯设备信息，可以直接新增、修改或者删除电梯记录，也可以查询部分电梯记录。 单击“新增设备”按钮，可以在界面上插入一个空行，输入内容后单击“保存”，即可新插入一条电梯记录。 直接编辑表格中任意内容，单击“保存”，即可修改任意一条电梯记录。 选中记录，单击“删除”，即可删除任意一条电梯记录。 设置查询条件，单击“查询”，可以查询满足条件的电梯记录。 图1 电梯设备信息管理界面 通过开发设备管理功能，带您学习如何在AstroZero中，开发脚本、服务编排、标准界面和高级界面，并在开发过程中，细致解析设备管理的增加、删除和修改，以及设备位置信息监控功能开发过程及原理。 父主题： 设备管理开发

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

响应示例 状态码： 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能力集