商用对接（联通用户专用）

总体说明

• 迁移对接的过程中，开发中心数据不割接，由应用服务器负责保存设备在开发中心的历史数据。
• 建议应用服务器先迁移商用环境再迁移设备，设备迁移采用API逐个重新注册的方式。

创建应用

1. 选择“设备管理”，登录设备管理服务控制台。

   

2. 系统已自动为用户创建一个应用，若使用默认应用，需要在“应用定义 > 安全”中重置密钥，且无需执行3至4。

   如果用户想要自己创建应用，需要将默认应用删除，重新创建。

   

3. （使用默认应用无需执行此步骤）参考下表按照实际情况填写配置参数。

   参数名称	参数说明
   基本信息
   应用名称	定义用户的应用的名称，应用名称必须为帐号下唯一，且创建后不可更改。
   所属行业	根据用户的应用的行业属性进行选择。
   消息跟踪数据授权	设置物联网平台运营管理员可以跟踪发生故障的设备的权限。 打开授权，表示平台管理员在辅助租户进行设备的故障定位时，可以跟踪设备上报的业务数据，便于快速解决问题。授权打开的状态下需要设置“授权时效”，可设置“指定时间”或者“永久有效”。为了保证用户的数据权益，物联网平台运维管理员跟踪的设备数据保留时间不超过3天。 关闭授权，表示平台管理员在辅助租户进行设备的故障定位时，不能跟踪设备上报的业务数据，可能导致没有足够的信息，将会降低问题定位效率，建议您授权给平台管理员进行业务数据的跟踪。
   消息推送
   选择协议	推送协议 应用服务器向物联网平台进行消息订阅，物联网平台在推送数据时可以采用加密的HTTPS协议或者非加密的HTTP协议。推荐采用HTTPS协议。 HTTPS方式：表示物联网平台与应用服务器之间采用加密的传输协议，需要应用服务器侧上传CA证书。 HTTP方式：表示物联网平台与应用服务器之间采用非加密的传输协议。此方式的安全性较低，存在物联网平台与应用服务器之间通信信息泄露风险。 CA证书 创建应用时无需上传CA证书，请创建完应用后根据配置数据推送业务上传CA证书。
   平台能力
   设备数据处理	物联网平台提供设备上报数据的存储能力，用户可以通过“存储历史数据”的开关进行控制，默认为“打开”状态。 打开开关：即物联网平台会对上报数据进行存储，存储时间以界面显示的存储时间为准。 关闭开关：即物联网平台不对上报数据进行存储。 用户可以通过数据转发规则转发到华为云其他云服务上进行存储和处理。
   推送服务	应用服务器向物联网平台订阅设备信息，物联网平台能够向应用服务器进行消息推送。
   其他
   应用描述	对该应用的描述。
   应用图标	为该应用添加自定义图标。

4. （使用默认应用无需执行此步骤）勾选“我已阅读并同意 《个人数据使用条款》”，单击“确定”，完成创建应用。创建完成后，系统弹出“成功”对话框，显示应用的基本信息，包含应用ID、应用密钥、应用对接地址和设备对接地址。
   • 请单击“保存密钥至本地”，以保存应用密钥信息，密钥信息在应用详细页内不可见，请妥善保管。如果遗忘应用密钥时，可在“应用列表”中单击，选择“重置密钥”，或者通过应用详情页内“应用定义 > 安全”进行重置密钥。
     

     应用ID和应用密钥用于应用服务器接入物联网平台，如果重置密钥，旧的密钥将不能使用，您的应用服务器需要更新为新的密钥才能重新接入平台，请谨慎操作。

   • 单击“查看应用详情”进入应用详情页，具体功能介绍参照“应用详情”。
   • 单击“返回应用列表”，返回到创建应用页。单击“应用列表”中应用的图标，可直接进入该应用的应用详情页。

导入产品模型

• 从产品中心导入产品模型
  1. 单击页面左下角的切换左侧菜单，打开“产品模型”页面，点击页面右上角的“新增产品模型 > 从产品中心导入”。

     

  2. 在产品中心选择已发布的产品，导入即可。

     

     

     如果您需要导入第三方私有产品，单击右上角“第三方私有产品”，填写产品验证码。产品验证码由第三方私有产品提供方在认证产品中心的“我的产品”页面，单击该产品的“获取产品码”得到。

• 本地导入产品模型
  1. 单击页面左下角的切换左侧菜单，打开“产品模型”页面，点击页面右上角的“新增产品模型 > 本地导入”

     

  2. 在弹出的页面，填写“产品名称”，导入本地产品模型的资源文件，点击“确认”按钮。

     

     

     选择“本地导入”的方式导入产品模型，如果产品模型的协议类型为LWM2M/CoAP，则需要联系华为技术支持上传插件。推荐您将产品发布到产品中心后再选择“从产品中心导入产品模型”。

迁移应用

迁移应用是指将对接了开发中心（测试环境）的应用服务器迁移到设备管理服务（商用环境）中去，您需要完成以下步骤：

1. 为了使应用服务器能对接这个业务使用空间，您需要将对接的平台地址修改为“设备管理服务”的应用对接地址，应用对接地址获取请参考平台对接信息。
2. 在“设备管理服务”中，应用对应的是开发中心的项目。为了使应用服务器能调用平台的接口，您需要将应用服务器中设定的应用ID和应用密钥修改为新的值。
3. 如果应用服务器调用“鉴权”接口成功，表明应用服务器已对接到商用环境。

迁移设备

迁移设备是指将对接了开发中心（测试环境）的设备迁移到设备管理服务（商用环境）中去。迁移对接的过程中，开发中心数据不割接，由应用服务器负责保存设备在开发中心的历史数据。

1. 您需要将设备根据通信协议修改对接的平台地址为“设备管理服务”的设备对接地址，设备对接地址获取请参考平台对接信息。
2. 您需要在“设备管理服务”中注册设备，可以使用应用服务器调用平台注册设备接口，也可以在界面上注册设备。
3. 平台为每一个注册到平台上的设备生成了一个deviceId，这是设备在平台上的唯一ID，您需要将设备和ID映射关系刷新为新的ID。

对接验证

将真实的设备和应用接入到物联网平台后，需要对设备上报数据到物联网平台，平台能正常将设备上报的数据推送给应用服务器进行验证；同时，验证应用服务器向设备下发命令，设备能正常收到命令并执行成功。

1. 设备上电，基于在设备上定义的业务逻辑进行数据采集，向物联网平台上报数据。
2. 登录“设备管理服务控制台”，选择“设备管理 > 设备 > 所有设备”，在设备列表中查看对应设备的状态。如果状态为“在线”，则表示设备已经成功接入物联网平台。

   

3. 点击对应的设备，进入设备详情页，在详情页中查看“最近上报数据”，如果能正常解析和显示对应的数据，则表示设备上报数据成功。

   如果需要查看所有上报的历史数据，则可以在设备详情的“历史数据”中进行查看。

   

4. 在CallBackURL对应的服务端中，查看是否收到物联网平台推送的数据，如果能正常接收，则表示物联网平台推送消息成功。
5. 通过应用服务器向设备下发命令，在设备侧查看设备的执行结果，如果设备的执行动作与下发的命令相符，且在“设备管理服务控制台”中查看下发命令任务的执行结果为“已送达”或“成功”，则表示应用服务器向设备下发命令成功。
   • 对于NB-IoT设备，如果采用的是缓存下发模式，需要触发设备再次上报数据后，命令才会下发给设备。
   • 如果设备会给物联网平台返回命令的执行结果（成功或失败），则命令下发的任务状态会根据执行结果刷新为“成功”或“失败”。

开始使用

物联网平台设备提供海量设备的接入和管理能力，配合华为云其他产品同时使用，帮助快速构筑物联网应用，简化海量设备管理复杂性，节省人工操作，提升管理效率。