批量添加物模型 - 阿里云物联网平台

在物联网平台控制台，通过导入物模型来批量添加属性、事件和服务，即将已编辑好的物模型JSON文件或其他产品的物模型导入为当前产品的物模型。本文介绍批量导入物模型功能的操作步骤。

前提条件

已创建产品。具体操作，请参见创建产品。

登录物联网平台控制台。
在控制台左上方，选择物联网平台所在地域。
在实例概览页签的全部环境下，找到对应的实例，单击实例ID或备注名称。
重要
目前仅开通企业版实例服务的地域下，执行此步骤。其他地域，请跳过此步骤，执行下一步。地域及实例的支持说明，请参见实例概述。
在左侧导航栏中，选择设备管理 > 产品。
在产品页面的产品列表中，单击产品对应操作列的查看。
在产品详情页面，单击功能定义页签，然后单击编辑草稿。
单击快速导入，然后在弹出的对话框中导入物模型。
支持两种批量添加方法。
- 在拷贝产品页签，选择物模型源产品和物模型版本，然后单击确定。
  源产品对应版本的默认模块和自定义模块物模型都会导入。您可在功能定义的编辑草稿页面，单击模块下功能对应的编辑按钮，修改该功能定义。
- 在导入物模型页签，上传物模型单个JSON文件或多个JSON文件的ZIP压缩包文件。
  物模型文件编写和打包要求，请参见什么是物模型。
  说明
  如果文件不符合要求，上传后会提示校验失败。您需根据提示，排查并修正文件后，重新上传。排查方法，请参见批量导入物模型，TSL检验失败怎么办？。

重要

物模型发布后，才会正式生效。

可选：单击添加发布备注，输入版本号和版本描述。

参数

说明

版本号

设置当前物模型版本号。后期可根据版本号管理物模型。

版本号支持英文字母、数字和英文句号（.），长度限制1～16个字符。

版本描述

描述当前版本物模型。支持中文汉字、英文字母、日文、数字和特殊符号。长度限制为100个字符。一个中文汉字算一个字符；一个日文算一个字符。

如果存在已上线的版本，则需要进行比对，确认新版本的修改点。
单击比对结果，在比对结果对话框中查看修改点。确认无误后，单击确认查阅，回到发布物模型上线对话框，自动选中“确认已查看当前版本与线上版本的比对结果”前的复选框。
如果不需要比对，您可直接手动选中“确认已查看当前版本与线上版本的比对结果”前的复选框。
单击确定，完成物模型的发布。

物模型发布后，物联网平台为该产品生成正式版本的物模型。在产品详情页面的功能定义页签下，您可以：

产品下设备上报的物模型数据默认会自动写入热数据存储空间，您可根据实际业务需要，停止部分或全部物模型的热数据存储服务。具体内容，请参见更新物模型数据存储。

API	描述
UpdateThingModel	更新指定产品物模型中的单个功能，支持更新物模型扩展描述。
QueryThingModel	查看指定产品的物模型中的功能定义详情。
CopyThingModel	复制指定产品的物模型到目标产品。
PublishThingModel	发布指定产品的物模型。
ImportThingModelTsl	为指定产品导入物模型TSL，暂不支持扩展描述配置。
QueryThingModelPublished	查看指定产品的已发布物模型中的功能定义详情。