实体

产品指某一类实体，创建完产品后，需要为实体创建身份。可以创建单个实体，也可以批量创建实体。这里是手动为产品下添加实体，获取实体证书信息用于后续的数据交换。也可以通过实体接入主动上报实体到DTS。

null

单个创建实体

null

参数	描述
产品	选择产品。新创建的实体将继承该产品定义好的功能和特性。
网关	选择网关。新创建的实体将继承该网关定义好的公共参数（属性）。
deviceId	设置实体名称。实体名称在产品内具有唯一性。实体名称长度为4-32个字符，可包含英文字母、数字和特殊字符，包括连接号（-）、下划线（_）、at符号（@）、点号（.）和英文冒号（:）。说明 deviceId可以为空。为空时，由DTS生成一个全局唯一标识符作为实体的deviceId。
备注名称	设置备注名称。备注名称长度为4-64个字符，可包含中文汉字、英文字母、数字和下划线（_）。一个中文汉字算2字符。

实体创建成功后，可以查看、复制实体证书信息。实体证书由实体的productId、deviceId和deviceSecret组成，是实体与DTS进行通信的重要身份认证，建议妥善保管。

参数	说明
productId	实体所隶属产品的Key，即DTS为产品颁发的全局唯一标识符。
deviceId	实体在产品下的唯一标识符。deviceId与实体所属产品的productId组合，作为实体标识，用来与DTS进行连接认证和通信。
deviceSecret	DTS为实体颁发的实体密钥，用于鉴权认证。需与deviceId成对使用。

批量创建实体

批量添加实体。

null

自动生成：无需为实体指定名称。填写实体数量后，系统将为每个实体自动生成由字母、数字随机组合成的deviceId。

批量上传：需要为所有实体指定名称。单击下载.csv模板下载表格模板，在模板中填写实体名称，然后将填好的表格上传至控制台。

从网关发现实体：选择创建的网关，设定需要请求的接口地址，系统将自动请求网关下的实体。根据选择的产品profile自动生成实体。

null

说明填写模板时，请注意： 1、实体名称长度为4-32个字符，可包含英文字母、数字和特殊字符，包括连接号（-）、下划线（_）、at符号（@）、点号（.）和英文冒号（:）。 2、实体名称在产品维度具有唯一性。列表中的实体名称不可重复，且不可与该产品下已有实体的名称重复。 3、一个文件中最多可包含1,000个名称。 4、文件大小不超过2 MB。

若批量上传的实体名称列表中有不合法的名称，将出现错误提示。请单击下载不合法列表，查看不合法的实体名称。根据实体名称规范，修改实体名称，再重新上传文件。

编辑实体

在实体页面选择需要编辑查看的实体，点击”编辑”进入实体详情页面。在实体详情页可查看到实体基本信息等内容。

null

实体信息

查看实体的基本信息包含产品信息和网关信息以及授权信息。

null

实体标签

通常根据实体的特性为实体添加的特有标记。实体标签信息会跟随实体在系统内部流转。该功能支持“可选择 + 可输入”的组合模式，支持两级标签管理。

参数	说明
标签分组 (一级标签)	标签分组名称，支持快速选择已有分组或自定义输入创建（如 `Status`、`Vendor`）。
标签 (二级标签)	具体标签值，支持快速选择已有标签或自定义输入创建（如 `Active`、`Hikvision`）。

Topic类

产品的所有Topic类会自动映射到实体上，无需单独为每个实体创建Topic。实体的自定义Topic可使用【发布信息】进行Topic消息的发送测试。

null

① 如果该Topic正在被使用，请谨慎操作，以防出现异常。服务端根据Topic判断是否进行数据解析，消息内容将发布到指定Topic。 ② 当Topic携带解析标记（?_sn=default）时，将执行对应的数据解析脚本，消息内容需匹配否则将消息发布失败。 ③ 当配置订阅关系时生效，消息内容仅支持JSON格式。