华为云用户手册

查看ICAgent状态 在主机管理页面的“主机”页签下方，查看目标主机的ICAgent状态。详细请参见表1。 表1 ICAgent状态 状态 说明 运行 该服务器的ICAgent运行正常。 未安装 该服务器未安装ICAgent。 安装中 正在为该主机安装ICAgent。安装ICAgent预计需要1分钟左右，请耐心等待。 安装失败 该主机的ICAgent安装失败。 升级中 正在升级该服务器的ICAgent。升级ICAgent预计需要1分钟左右，请耐心等待。 升级失败 该服务器的ICAgent升级失败。 离线 输入的AK/SK错误导致该主机的ICAgent功能异常。请获取正确的AK/SK后重新安装。 异常 该主机ICAgent功能异常，请联系技术支持。 卸载中 正在卸载该主机。卸载ICAgent预计需要1分钟左右，请耐心等待。 鉴权错误 安装该主机时配置的参数问题导致无法正常鉴权。

查看ICAgent版本说明 在主机管理页面的“主机”页签下方，查看目标主机的ICAgent版本。详细请参见表2。 表2 ICAgent版本说明 版本号 说明 发布时间 5.12.185 解决虚机日志配置中黑名单路径不生效问题。 优化containerd标准输出日志采集的问题。 2024-05-20 5.12.184 解决容器日志采集功能中无法排除绕接文件的问题。 节点日志采集功能并发采集协程调整为32个。 2024-05-16 5.12.183 优化containerd节点采集容器标准输出绕接文件的问题。 2024-05-11 5.12.182 解决syslog开关问题。 2024-04-28 5.12.181 解决自建k8s icagent认证失败问题。 解决日志截断问题。 解决日志速率很大的情况下，查找不到绕接文件导致文件漏采的问题。 2024-04-25 5.12.177 解决绕接死循环问题。 2024-03-28 5.12.176 zip流式解析优化：检查转储文件是否结束。 限制podlb每个主机最大连接数。 2024-03-18 5.12.175 解决了结构化日志采集性能瓶颈问题。 2024-03-13 5.12.172 优化支持的绕接方式。 2024-02-28 5.12.171 解决Docker节点标准输出日志Json解析问题（没有去掉转义字符）。 2024-01-31 5.12.170 主机日志，容器日志，标准输出日志支持增量采集。 解决主机gpu指标挂断问题。 2024-01-29 5.12.166 解决标准输出日志采集插件占用内存高问题。 解决虚机日志采集插件重复采集绕接文件问题。 游标文件中添加日志组和日志流信息。 2023-12-27 5.12.165 从配置文件获取初始agentID，如果不符合校验要求则使用随机生成的uuid。 2023-12-21 5.12.163 支持UniAgent插件化安装ICAgent。 2023-12-13 5.12.159 解决标准输出日志采集协程泄露问题。 解决标准输出日志采集到 AOM 后，不支持采集标准输出绕接日志的问题。 2023-11-27 5.12.158 解决关闭指标开关后容器指标内存泄露导致ICAgent重启的问题。 2023-11-08 5.12.157 CCE接入LTS的容器日志采集：支持Docker驱动Devicemapper。 解决虚机日志量大（转储快）ICAgent内存暴涨导致重启问题。 2023-11-06 5.12.156 解决从OBS拉取安装包问题，将http协议改成https。 2023-11-01 5.12.154 支持结构化功能。 2023-10-31 5.12.153 Release7版本。 2023-10-19 5.12.150 解决集群name和集群id not-set问题。 支持CCE集群1.27版本。 2023-10-17 5.12.149 支持挂载绕接功能。 2023-10-12 5.12.148 修复gpu多卡场景，解决cpu高的问题。 2023-08-30 5.12.147 修复日志转储无法重启、主机gpu指标适配。 2023-08-17 5.12.142 支持CCE集群1.25及以上版本的容器gpu指标采集。 2023-06-13 5.12.139 解决上报LTS日志出现大量TIME_WAIT状态的TCP连接问题。 2023-04-25 5.12.135 解决CPU使用率为0的问题。 解决CCE1.23版本集群containerd节点容器网络指标缺失问题。 支持采集EulerOS 2.5系统的磁盘分区指标。 2023-02-08 5.12.133 容器的标准输出日志支持多行采集。 2022-12-17 5.12.130 支持将CCE日志直接接入LTS。 2022-11-04 5.12.120 增加进程的最大句柄数指标。 支持LTS的podlb 域名 的切换能力。 2022-08-28 5.12.111 新增线程指标、修复“获取lvs磁盘分区指标失败”问题。 2022-06-09 5.12.100 上报内存指标增加内存workingset使用量、内存workingset使用率。 容器采集支持通过标签区分stderr.log和stdout.log。 容器上报增加Pod_ip的tag。 **配置匹配当前目录文件。 2022-01-15 5.12.98 增加LTS日志黑名单功能，更改容器指标来源为working_set。 2021-09-29 5.12.96 新增云资源发现类型。 2021-09-22 5.12.90 更新gpu指标来源。 2021-07-15 5.12.87 新增磁盘支持类型。 2021-03-30 5.12.75 适配安全容器场景。 2021-03-09

操作场景 虚拟私有云可以为您的容灾站点服务器提供隔离的、用户自主配置和管理的云上虚拟网络环境。 异步复制其实就是将本地主数据中心中需要容灾的服务器的数据，实时复制到云上用户的专有网络中。当本地数据中心发生重大故障时，可以将业务切换到云上VPC中运行容灾站点服务器上，从而保持业务的连续性。 创建云上专有网络时需要考虑的因素： 容灾区域 需要根据业务对容灾系统的实际要求进行选择，如生产站点和容灾站点间的物理距离、网络性能以及网络成本等因素来选择容灾区域，如业务要求生产站点和容灾站点间的物理距离不低于100KM，网络时延小于100ms，同时成本限制不能使用专线等。 本地数据中心和华为云VPC间的连接网络 公网：适用于数据变化量不大，且本地生产数据中心的系统无需频繁访问云上资源的场景。 VPN：适用于数据变化量不大，本地生产数据中心需要随时连接华为云VPC内业务的场景。如用户有部分业务部署在华为云，本地数据中心的业务当前就是通过VPN与云上的业务进行交互，进行异步复制时就可以使用该VPN连接。 云专线：针对数据量较大且应用较复杂的场景，通常需要根据业务的具体数据变化量进行规划。 VPC的网段 用于运行切换或者容灾演练时创建的E CS ，如果需要保持切换或者容灾演练创建的ECS的IP地址和本地数据中心的生产站点服务器一致，可以将VPC的网段和本地生产数据中心的网段设置成相同的。业务切换或者容灾演练时，就可以保持服务器的IP地址不变，无需修改相关的配置。

如何选择数据节点RDS for MySQL的规格 数据节点RDS for MySQL的规格建议不小于DDM的规格，否则会产生木桶效应，影响性能。 示例： Q：例如DDM是8核16GB，那么RDS for MySQL的规格应该选多少？应该选择主备还是单机架构？ A：根据最佳实践结果，一般建议DDM和RDS for MySQL的资源比保持在1:2。如果DDM是8核16GB，需要选择2个或以上8核16GB的RDS for MySQ L实例 ，RDS for MySQL的具体数量还需参考业务整体数据量综合考虑。 对于生产业务使用的实例，RDS for MySQL需选择主备架构来保证高可用。 父主题： RDS相关类

URI POST /v1/workflow-adapter/flows/{flow_id}/execution/public 表1 路径参数 参数 是否必选 参数类型 描述 flow_id 是 String 流id。 表2 Query参数 参数 是否必选 参数类型 描述 query_example 否 String 按照用户配置的工作流请求参数配置，如果用户配置的工作流输入存在查询参数，则应该配置对应的参数并在调用时输入特定的值。

响应示例 状态码： 200 请求被服务所理解，正常调用。 { "data" : { "responseBody" : "something in response body", "responseHeaders" : { "Server" : "api-gateway", "X-Request-Id" : "787b7740f42e75b007ac3bfb599fcef4", "X-Content-Type-Options" : "nosniff", "Connection" : "keep-alive", "lubanops-nspan-id" : "1", "X-Download-Options" : "noopen", "Date" : "Tue, 23 Jul 2024 11:38:29 GMT", "lubanops-ntrace-id" : "2748112-1721734708992-1130609", "Referrer-Policy" : "no-referrer", "X-Frame-Options" : "SAMEORIGIN", "Strict-Transport-Security" : "max-age=31536000; includeSubdomains;", "lubanops-nenv-id" : "28164", "Content-Length" : "0", "X-XSS-Protection" : "1; mode=block;", "Content-Type" : "application/json" }, "statusCode" : 200 } } 状态码： 500 服务器内部错误或三方服务器内部错误。 { "error_code" : "AIAE.22001003", "error_msg" : "Internal Server Error." }

数据上报失败如何处理？ 若设备是使用接口注册的，请确认设备是否因为没在指定的timeout时间内上线而被 物联网平台 自动删除了。如果设备已被删除，请重新注册设备再尝试上报数据。 请检查使用接口注册设备时，填写的产品信息是否和产品模型一致。 请检查上报的数据名称是否和产品模型定义的服务属性一致。 确定以上都不存在问题时，请检查设备和物联网平台之间的网络链路是否畅通，设备是否正常运行。 若设备为NB-IoT设备，请再参考NB模组无法正常上报数据怎么办？进行排查。

为何上报中文数据，平台会乱码呈现？ 问题描述 使用MQTT.fx设备模拟器进行数据上报时，在json字符串中携带中文字符，如下图： 图4 MQTT.fx数据上报截图 上报至IoTDA平台后，会出现乱码情况，如下图： 图5 设备-设备属性乱码样例 可能原因 MQTT.fx设备模拟器不支持中文字符。 解决办法 与平台交互时，不使用中文字符。 请将上报数据中的中文字符进行Unicode编码处理。 替换第三方设备模拟器，推荐使用IoTDA自研的设备模拟器。

命令下发失败如何处理？ 问题描述 调用命令下发接口报错或调用接口成功但设备未收到命令。 可能原因 设备协议不支持。 设备订阅的下行topic不正确或者设备上行topic及消息体不正确。 解决方法 确认使用的接口是否支持设备协议（同步命令下发当前仅支持MQTT协议设备）。 同步命令下发操作步骤： 确认设备订阅下行topic是否正确（需订阅成功后才可调用接口，不订阅，设备收不到平台消息），详细请参考平台命令下发接口文档。 若设备有收到平台下发的消息，确认设备上行topic及消息体是否正确，且必须在收到平台消息20s内（消息接口不限定20s），通过上行topic向平台发送，否则接口报错（request_id为下行消息中携带）。 异步命令下发操作步骤： 确认是立即下发还是缓存下发（根据入参的send_strategy判断）。 立即下发：设备在线，调用接口后设备立即收到。 缓存下发：调用接口后，设备上报数据后收到。

物联网平台的命令状态总共有几种？ LWM2M/CoAP设备命令下发状态 物联网平台命令下发包含如下状态： 超期：表示命令在物联网平台缓存时间超期，未向设备下发。 成功：表示物联网平台已经将命令下发给设备，且收到设备上报的命令执行结果。 失败：表示编解码插件解析为空，或执行结果响应里面有“ERROR CODE”等。 超时：表示物联网平台等待ACK响应超时。 取消：表示应用侧已经取消命令下发。 等待：表示命令在物联网平台缓存，还未下发给设备。 已发送：表示物联网平台已经将命令下发给设备。 已送达：表示物联网平台已经将命令下发给设备，且收到设备返回的ACK消息。 各命令状态之间的转换如下图所示： 图6 命令状态转换图 MQTT设备下发消息状态 等待：MQTT设备不在线，物联网平台会将消息进行缓存，此时任务状态为“等待”状态。 超时：物联网平台缓存的PENDING状态的消息，如果1天之内还没有下发下去，物联网平台会将消息状态设置为"超时”。 已送达：物联网平台将消息发送给设备后，状态变为“已送达”。 失败：物联网平台发送消息给设备不成功，消息状态变为“失败”。 各消息状态之间的转换如下图所示： 图7 消息状态转换图

物联网平台下发异步命令有重发机制吗？ 物联网平台具备异步命令重发机制。异步命令发送后（可以在设备接入的命令详情中查看命令发送时间）：如果物联网平台未收到设备返回的ACK，则在10s~15s后会进行第一次重传。如果物联网平台仍未收到设备返回的ACK，在20s~30s后进行第二次重传。如果物联网平台依旧未收到设备返回的ACK，在40s~60s进行第三次重传。如果物联网平台在80s~180s后还没收到设备返回的ACK，则命令状态变为超时。

IoT Device SDK C Tiny相关问题 LiteOS操作系统层面相关技术问题解答。 请移步LiteOS社区。 日志中出现诸如mqtt_imp_init: ###please implement mqtt by yourself####此类问题。 首先检查编译架构中对于__attribute__ ((weak))函数的支持性，如果不支持，建议将这些函数全部注释掉；如果出现link_tcpip_imp_init:###please implement this function by yourself####，建议检查是否实现网络层的适配。 在使用SDK时发现某些任务执行顺序与任务优先级顺序不符？ SDK中默认使用的优先级从大到小依次为0-31，用户可根据不同的操作系统自行调整相应任务的优先级。 SDK移植流程主要包括哪些步骤？ 移植过程主要包括操作系统注册到OSAL层以及TCPIP注册到SAL层，同时可以根据需求进行模块化裁剪，详见开发指南。 使用MQTT协议对接华为云时，返回错误码2 具体日志如下所示 图1 MQTT链接错误提示 该问题为网络错误，首先建议用户检查开发板是否已经联网成功，如果网络联通，建议检查所要对接网络的IP地址或域名以及端口号是否正确，如linux环境下，可以ping所要对接的网络地址查看是否ping通。 客户在对接华为云时，出现网络断连接后，在恢复网络时设备没有自动重连。 图2 断链没有重连日志提示 日志中可见PAHO已经退出，设备已经与平台断开连接，主动下线。建议客户修改SDK目录中的network\mqtt\paho_mqtt\port\paho_mqtt_port.c文件中的函数__loop_entry()中的休眠时间1ms调大至100ms，具体为：osal_task_sleep(100)，查看是否可以自动重连。 使用MQ TTS 对接华为云时，流程卡死在topic订阅阶段，参考日志如下所示。 图3 流程卡死topic订阅日志提示 请将iot_config.h文件中的宏CONFIG_PAHO_LOOPTIMEOUT调整为1000。 开发板使用MQTT对接华为云成功，但切换到MQTTS时对接失败 可能是开发板内存不足导致，建议测试下开发板剩余内存，建议内存尽量大于60K，如在OpenHarmony L0设备中可以调用接口LOS_MemPoolSizeGet(m_aucSysMem0)获取总内存，LOS_MemTotalUsedGet(m_aucSysMem0)获取已使用内存，做差即可获取到剩余内存，如果移植了shell也可以通过free指令获取到当前内存情况。 采用MQTT对接华为云的正确日志如下所示，应如何解读？ 图4 MQTT正常建链日志提示 日志中第3、4行是MQTT协议对接华为云必现日志，若使用MQTTS则会出现第2行日志；如果使用适配sal的tcpip协议则会出现第1行日志；若相应日志没有打印，建议根据文件link_main.c找到对应功能的初始化函数所对应的宏，之后在iotlink_config.h中检查对应的宏是否打开。 设备断电之后在IoTDA平台仍然可以看到设备在线？ 如果设备没有主动断链通知平台下线，则设备下线时间与代码中的MQTT心跳时间lifetime相关，为1.5倍的心跳时间，在MQTT建立连接时，连接参数中对lifetime进行设置即可。 目前已经移植了IoT Device SDK Tiny（附代码）的设备清单 详见移植设备清单列表。

IoT Device SDK 和IoT Device SDK Tiny有什么区别？ 相比于IoT Device SDK，Tiny版本更加轻量，适用于内存以及磁盘空间更小的设备，且一般很少挂载子设备，在编译中没有使用动态链接库，代码提供了操作系统抽象层，可适配多种OS，例如FreeRTOS、linux、NovaOS、ucos_ii、OpenHarmony LiteOS-M等；除MQTT(S)还支持LwM2M,CoAP协议，Tiny使用的mbedtls加密，IoT Device SDK C采用的openssl加密。详细请参考IoT Device SDK介绍。

设备管理服务和 设备接入服务 合一后的差异点是什么？ 设备管理服务和设备接入服务合一后，主要有以下变更点： 功能：全新升级后的设备接入服务（IoTDA），整合了原设备接入服务和设备管理服务的功能，新用户只需开通设备接入服务，即可同时使用设备接入和设备管理的全部功能。 计费：已开通过设备接入服务的用户，可叠加使用设备管理服务的功能，按消息数计费的方式不变；原设备接入服务和设备管理服务都已开通使用的用户， 业务使用不受影响， 自2020年3月26日00:00（北京时间）起，计费方式请参考计费模式。 父主题： 方案咨询

使用小熊派开发板开发时，设备无法激活？ 可以输入“AT+CGATT?”，然后单击“发送”，若返回“+CGATT:1”，表示网络附着成功（附着成功代表NB-IoT联网正常），返回“+CGATT:0”表示网络附着失败，请查看SIM卡是否插入正确，或联系运营商检查网络状态; 或者可以将拨测开关拨到AT-PC模式，选择STM的端口，波特率设置为9600，输入指令“AT+CGSN=1”获取IMEI号，比较跟在平台注册设备时填写IMEI号是否保持一致，不一致的话，需要修改成一致的。

物联网卡无法正常接入设备接入平台？ 电信NB物联网卡 由于电信NB网络做了限制，目前电信NB卡连接华为云IoT平台，会出现设备接入平台或执行软固件升级失败等情况。 3G/4G物联网卡 根据工网安函〔2020 〕1173 号文件，3G/4G物联网卡流量包规格大于100MB或配置流量池的情况下，需要提供定向IP地址或域名才能购买。因此如果您的物联网卡需要访问华为云IoT平台时，请您检查物联网卡的定向信息是否包含华为云IoT平台的域名。 图7 物联网卡 查询华为云IoT平台接入域名，详细步骤可以参考资源获取。 GSL控制台定向域名/IP修改方式进入订单管理页面，详细步骤请参考订单管理资料。 电信NB物联网卡通过云云对接接入华为云IoT平台的功能正在公测中，如有相关诉求请新建工单，联系相关技术专家进行处理。

deviceId、nodeId和IMEI有什么对应关系？ 在物联网平台中，设备注册时，需要填写设备标识码（即nodeId）。设备标识码是设备的物理标识，通常使用IMEI或MAC地址。设备ID（deviceId）是物联网平台对设备的逻辑标识。 NB-IoT设备：在设备接入物联网平台时携带设备标识码（nodeId），完成设备的接入鉴权。 MQTT设备：在设备接入物联网平台时携带设备ID（deviceId）和密钥，通过一机一密的方式，完成设备的接入鉴权。 更多请参考设备注册鉴权。

创建规则或者设置资源文件存储时候提示赋予Security Administrator权限 使用 IAM 用户访问设备接入服务，创建规则或者设置资源文件存储时提示“请联系管理员给您所在的用户组赋予Security Administrator的权限”，表明IAM用户没有授予委托管理权限，请参考以下操作配置权限。 方法1：创建一个自定义策略（包括查询、创建委托、查询角色等功能），并添加到IAM用户所在的用户组中（推荐该方法） 使用管理员账号登录IAM控制台，单击左侧导航栏的“权限管理--权限”，单击页面右上角的“创建自定义策略”。 策略名称：自定义； 策略配置方式：json视图； 策略内容：参考如下填写； { "Version": "1.1", "Statement": [ { "Action": [ "iam:agencies:createAgency", "iam:agencies:listAgencies", "iam:agencies:getAgency", "iam:permissions:listRolesForAgencyOnDomain", "iam:permissions:listRolesForAgencyOnProject", "iam:permissions:grantRoleToAgencyOnProject", "iam:permissions:revokeRoleFromAgencyOnProject", "iam:permissions:grantRoleToAgencyOnDomain", "iam:permissions:revokeRoleFromAgencyOnDomain", "iam:permissions:checkRoleForAgencyOnProject", "iam:permissions:checkRoleForAgencyOnDomain", "iam:roles:createRole", "iam:roles:listRoles", "iam:roles:getRole" ], "Effect": "Allow" } ] } 单击确定，完成自定义策略的创建 选择左侧导航栏的“用户组”，单击对应用户组进入用户组详情。 单击“授权记录“页签，单击“授权“按钮。 进入“授权--选择策略“页面，勾选步骤1中创建的策略，单击”下一步” 在”授权--设置最小授权范围”页面，选择”所有资源”，单击”确定”，完成授权。 方法2：为IAM用户所在的用户组授予Security Administrator的权限 登录IAM控制台，选择左侧导航栏的“用户组”，单击对应用户组进入用户组详情。 在“授权记录”页签下单击“授权”，搜索“Security Administrator”然后选择“Security Administrator”策略，单击”下一步”。 注：该权限具有委托、角色、用户管理等所有功能，权限范围大，请按实际需要分配。 在”授权--设置最小授权范围”页面，选择”所有资源”，单击”确定”，完成授权。 父主题： 方案咨询

热门问题 设备管理服务和设备接入服务合一后的差异点是什么？ 如何获取对接物联网平台的地址？ 如何获取新域名和老域名接入的地址/证书？ 新旧域名接入的鉴权方式有什么区别？ 命令/属性下发总是超时？ 应用侧如何获取appid和secret？ Java SDK中有多个demo，该参考哪一个demo？ C版 SDK中有多个demo，该参考哪一个demo？ 如果是TCP协议，或者自定义协议如何接入平台？ 设备显示上报数据成功，在控制台未看到数据？ 应用服务器调用接口失败怎么处理？ 应用服务器如何获取设备上报到物联网平台的数据？ 如何制作订阅推送调测证书？ 调用订阅接口时，回调地址如何获取？ 订阅后消息推送失败如何处理？ 物联网卡无法正常接入设备接入平台？ 为何上报中文数据，平台会乱码呈现？

在线开发的插件部署失败如何处理？ 问题描述 用户在插件开发界面开发好了编解码插件，单击部署按钮部署失败了 可能原因 如果插件下载成功，但是部署失败，则可能是网络问题导致 如果插件下载失败，则部署失败的原因如下： 同类消息的（例如：两种数据上报的消息）messageId的值设置重复或在消息中的位置不一致。 messageId的数据类型设置为非int型。 存在字段的默认值设置为非16进制数。 存在字段名字设置为java关键字，比如type、int等 解决方法 插件如果可以成功下载，但是部署失败，请检查网络状态，并重试。 如果插件下载失败，请排查插件定义是否符合规范。

在线开发插件中地址域（messageId）如何使用？ 当有相同类型的消息时（例如：两种数据上报的消息），需要添加地址域字段，用于区分不同的消息，且该字段在字段列表的位置必须一致。场景如下： 有两条及以上的数据上报消息或命令下发消息。 命令响应消息可看作一种数据上报消息，因此如果存在命令响应消息，则需要在数据上报消息中添加地址域。 数据上报响应消息可看作一种命令下发消息，因此如果存在数据上报响应消息，则需要在命令下发消息中添加地址域。

在线开发的插件中如何实现命令下发响应？ 设备在接收到命令后，可以上报两类消息：ACK和命令下发响应。ACK用于表示命令已经到达设备，命令下发响应用于表示设备执行命令的结果。如果需要设备在接到命令后，需要返回命令下发响应，则： 需要在数据上报消息和命令响应消息中均定义地址域字段（messageId），并且该字段在两种消息的字段列表中的位置必须相同，使编解码插件可以对数据上报消息和命令响应消息进行区分。 需要在命令下发消息和命令响应消息中定义响应标识字段（mid），并且该字段在两种消息的字段列表中的位置必须相同，使编解码插件可以将命令下发消息和对应的命令响应消息进行关联。

常见的软/固件升级错误有哪些？ 在软/固件升级时，可以在“执行详情”的任务列表中查看错误描述，常见错误描述如下： 表1 软固件升级错误描述 失败原因 原因解释 处理建议 Device Abnormal is not online 设备未在线 请检查设备侧是否在线。 Task Conflict 任务冲突 请检查当前设备是否有软件升级、固件升级正在进行。 Waiting for the device online timeout 等待设备上线超时 请检查设备侧是否上线。 Waiting for report cellId timeout 等待上报cellId超时 请通过模组日志检查设备侧是否上报的小区ID。 Waiting for report device firmware version timeout 等待上报设备固件版本超时 请通过模组日志检查设备侧是否上报了固件版本号。 Wait for the device to report upgrade result timeout 等待设备上报升级结果超时 请通过模组日志检查设备侧是否上报了升级结果。 Updating timeout and query device version for check timeout 等待升级结果超时，且等待设备版本信息超时 请通过模组日志检查设备侧是否上报升级结果及上报设备版本信息。 Waiting for device downloaded package timeout 等待设备下载固件包超时 请通过模组日志检查设备侧是否下载固件包。 Integrity check failure for new downloaded package 下载的固件包完整性校验失败 请通过模组日志检查设备下载的固件包是否完整。 Unsupported package type 固件包类型不支持 请通过模组日志检查设备状态和厂商提供的固件包是否正确。 Not enough storage for the new firmware package 下载的固件包存储空间不足 请检查设备存储。 Out of memory during downloading process 下载过程中内存不足 请检查设备内存。 Connection lost during downloading process 下载过程中连接断开 请检查设备连接状态。 Invalid URI URI不可用 检查设备侧的固件包下载地址是否正确。 Firmware update failed 固件更新失败 请通过模组日志检查设备侧。

NB模组绑定设备失败怎么办？ 使用NB模组和真实NB网络接入物联网平台时，第一步就是接入平台绑定设备。 如果设备绑定失败，可能的原因有很多种，您可按照下述指导逐个定位排查问题。 在物联网平台上注册设备时，设备标识（对应应用侧注册设备接口的nodeId）是否为NB模组的IMEI号？timeout设置的时间是否够长？ 使用NB模组接入物联网平台时，必须直接使用NB模组的IMEI号作为nodeId。同时，timeout设置的时间也不要太短，设备必须在注册成功后的这个时间内发送绑定请求到物联网平台。 注册设备时的产品信息是否和产品模型一致？ 使用控制台注册设备时注意选择正确的产品模型。 NB模组是否能收到NB基站的信号？ NB模组，通过AT+CSQ?命令查询NB信号强度。没有信号或强度过低，需要联系运营商进行调整。 NB模组是否能够附着网络？ NB模组，通过AT+CEREG？获取注册网络信息，如果返回状态为未注册或者注册被拒绝，则联系运营商，进行沟通。可能是NB模组的版本与运营商基站的版本不匹配。 NB模组是否能够ping通华为云物联网平台？ NB模组，通过AT+NPING命令，尝试ping华为云物联网平台。如果无法ping通，则说明运营商网络无法连接到公网。则需要联系运营商，询问该地运营商的核心网是否没有连到公网，是否只能连接该地运营商的物联网平台；或者与运营商协商，看怎么能够打通隧道，连到公网。 NB模组是否正确设置平台的域名和端口？ NB模组，通过AT+NCDP命令，设置连接的华为云物联网平台的域名和端口。域名和端口请登录设备接入管理控制台，查看协议为CoAP或CoAPS的设备对接信息。 发送给NB模组的AT命令是否以\r\n结尾？ 发送给NB模组的每条指令都必须以\r\n结尾。如果不以\r\n结尾，命令会在NB模组中缓存。 NB模组检测发送的数据上报状态是否为SENT? NB模组，通过AT+NQMGS，检查已经发送的命令状态。 PENDING，表示数据已发出，但是平台没有进行响应。 SENT，表示数据已发出，且平台进行了响应。 ERROR，表示数据上报异常。 如果状态为PENDING和ERROR，一般来说是网络问题，需要从基站和核心网侧进行分析。 NB模组发送的AT+NMGS数据是否能够被正常解析？ 使用编解码插件检查工具，检测自己准备发送的码流是否可被正常解析。

NB模组无法正常上报数据怎么办？ NB模组绑定设备是和第一条数据上报一起完成的，如果NB模组绑定失败，即NB模组发送数据给平台，但是从物联网平台上看到的设备仍然未激活，请参照NB模组绑定设备失败怎么办？进行排查。 以下定位指导，是基于物联网平台上看到设备已经在线的前提。 发送给NB模组的AT+NMGS命令是否以\r\n结尾？ 发送给NB模组的每条指令都必须以\r\n结尾。如果不以\r\n结尾，命令会在NB模组中缓存。 发送的AT+NMGS的payload，是否可以被编解码插件正确解析？ 使用编解码插件检查工具，检测自己准备发送的码流中的payload，查看解析后输出的消息结构是否正确，是否符合产品模型定义。

NB设备接入时，出现513错误？ 终端设备每次上电后，都会向物联网平台发起TUP注册流程。TUP协议为华为私有协议，包装在CoAP协议之上，与LWM2M协议类似。海思芯片设置TUP注册过程不能超过4s，如果在4s内未完成TUP注册，则上报513错误。 当出现此513错误时，可以按照如下方法进行处理： 当网络环境状态不佳时，会导致注册过程概率性超过4s，从而出现513错误。请联系NB网络运营商检查网络状态。 通过AT+NMGS发送业务数据会触发注册，如果4秒钟内没有收到t/d资源（收发业务数据资源）的订阅，就会返回错误，但依赖CoAP层的重传继续注册，最长160秒后还是没有收到t/d资源的订阅，这次注册就会失败。160s基本可以保障终端设备能够注册成功，4s返回ERROR只会丢掉第一包的数据。建议设备重启并再发送AT+NMGS触发上述注册流程。 可通过 AT+NMSTATUS 查询注册状态，返回+NMSTATUS:MO_DATA_ENABLED 表示成功注册。

订阅后消息推送失败如何处理？ 问题描述 订阅后，应用服务器未正确接收到推送消息，或参考“连通性测试”，在设备接入管理控制台中使用连通性测试功能测试“第三方应用服务（HTTP推送）”，结果为推送失败。 图2 转发目标-连通性测试结果 可能原因 如果订阅地址是HTTPS地址，可能是服务端的证书制作有问题或者服务端证书对应的CA证书未上传至物联网平台 订阅地址对应的服务端口未开放。 若订阅地址为域名，并且域名绑定多个IP，可能是DNS解析问题。 解决方法 如果订阅地址是HTTPS地址，商用时，推荐向证书机构申请证书，然后参考设备接入平台上传证书进行证书上传。如果是调测时请先确保证书制作过程无误。上传证书时如果打开了“是否检查CNAME ”开关，需要确保应用服务器的域名地址和证书中的CNAME一致；证书中的CNAME可通过证书校验工具查看。 请确认订阅地址对应的服务端口是否开放。可在其他外网机器上使用telnet命令验证下您的IP和端口是否已开放，若未开放，请将其开放或修改订阅的IP和端口。 若订阅地址为域名，并且域名绑定多个IP，请确认DNS解析后的IP地址是否正确且可达。 使用设备接入管理控制台提供的“消息跟踪”功能，触发推送后，查看消息跟踪的数据，确认平台是否触发订阅推送，以及是否推送成功。 请在应用服务器抓包确认是否接收到设备接入平台推送的消息。

调用订阅接口时，回调地址如何获取？ 以业务应用订阅设备数据变化通知为例，订阅和推送的流程如下： 图1 订阅推送流程图 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知（携带回调地址和通知类型），物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。 设备上报数据给物联网平台。 物联网平台根据订阅时设置的回调地址，将设备数据主动推送给业务应用。 什么是回调地址？ 回调地址（callbackUrl）是指业务应用自定义的，供外部访问的restful接口地址。当物联网平台向业务应用推送消息时，实际是调用业务应用的restful接口把数据发给业务应用。 回调地址的请求方式必须为POST。 怎样获取回调地址？ 回调地址由通信方式、业务应用的访问地址和restful接口的URL组成，如https://server:port/URL。 通信方式建议使用https协议，保证业务应用与物联网平台的通信安全。使用https协议通信时，物联网平台需要加载证书，制作证书参考证书制作。 由于业务应用所在的网络不同，业务应用的访问地址也不同。 业务应用部署在公网时，业务应用的访问地址就是业务应用的公网IP:端口（或域名:端口）。 业务应用部署在局域网时，需要在业务应用配置网络穿透，生成业务应用的公网访问地址，具体配置自行从网上获取网络穿透工具的配置步骤。 不同通知类型的订阅，回调地址可以相同也可以不同，根据业务需求自定义。

设备数据变化通知和批量设备数据变化通知的区别是什么？ 设备数据变化通知和批量设备数据变化通知接口都是订阅设备的数据变化，只是封装的数据格式不一样。 例如：一款水表设备有Battery和Connectivity两种服务类型，每次上报数据都会上报这两个服务的数据。 如果订阅deviceDatachanged（设备数据变化通知），则物联网平台分两次将数据推送到应用服务器，第一次推送Battery服务数据，第二次推送Connectivity服务数据。例如： { "notifyType":"deviceDataChanged", "deviceId":"********", "gatewayId":"********", "requestId":null, "service":{ "serviceId":"battery", "serviceType":"battery", "data":{ "batteryLevel":66 }, "eventTime":"20170211T034003Z" } } { "notifyType":"deviceDataChanged", "deviceId":"********", "gatewayId":"********", "requestId":null, "service":{ "serviceId":"Connectivity", "serviceType":"Connectivity", "data":{ "signalStrength":72, "cellId":4022250974, "tac":61374, "mnc":91, "mcc":235 }, "eventTime":"20170211T092317Z" } } 如果订阅deviceDataschanged（批量设备数据变化通知），则物联网平台将两次服务的数据封装在一起发送到应用服务器。 { "notifyType":"deviceDatasChanged", "requestId":null, "deviceId":"********", "gatewayId":"********", "services":[ { "serviceId":"battery", "serviceType":"battery", "data":{ "batteryLevel":66 }, "eventTime":"20170211T034003Z" }, { "serviceId":"Connectivity", "serviceType":"Connectivity", "data":{ "signalStrength":72, "cellId":4022250974, "tac":61374, "mnc":91, "mcc":235 }, "eventTime":"20170211T034003Z" } ] }

为什么设备上报一条数据后应用服务器会收到多条推送？ 可能有以下几种情况： 如果订阅的“notifyType”为“deviceDataChanged”，且多条消息推送的内容不同，可能是因为设备上报的数据包含了多个service（即“data”参数内包括多个JSON对象），物联网平台会将其拆成多条消息推送。 如果是接到两条消息，且一条消息的“notifyType”为“deviceDataChanged”，另一条消息的“notifyType”为“deviceDatasChanged”，说明您同时订阅了设备数据变化和设备数据批量变化，这种情况下设备上报数据物联网平台会推送两条消息。 如果是相同的消息反复推送，可能是因为应用服务器没有及时对推送消息返回响应，物联网平台认为推送失败了，启动了重推机制反复推送相同的消息。