thingsboard属性

### ThingsBoard 属性使用指南

#### 什么是属性
在ThingsBoard平台中，属性用于存储实体（如设备、资产等）的状态信息。这些状态信息可以是静态配置参数或是动态变化的数据。根据其作用范围和更新机制的不同，属性被分为客户端属性和服务端属性两种类型[^1]。

#### 客户端属性 vs 服务端属性
- **客户端属性**：由终端设备上报给服务器并仅能通过API接口读取；适用于保存那些不需要频繁变更也不必同步至其他地方的信息。

- **服务端属性**：可以在ThingBoard内部设置并通过REST API或其他方式修改；适合用来表示一些全局性的设定或者是需要跨多个组件间共享的数据项[^2]。

#### 如何操作属性
对于这两种类型的属性，在ThingsBoard中有多种途径来进行增删改查：

##### Web界面管理
登录到ThingsBoard实例之后进入具体某个设备详情页即可看到“Attributes”标签栏，在这里可以直接编辑已存在的属性值或者新增加新的键值对[^3]。

##### RESTful APIs调用
如果希望通过编程手段自动化处理，则可利用官方提供的RESTful风格Web Service API完成相应功能。例如向`/api/v1/{deviceToken}/attributes`发送POST请求就可以上传一批最新的客户段属性记录[^4]。

curl -X POST "http://localhost:8080/api/v1/$ACCESS_TOKEN/attributes" \
-H "Content-Type: application/json" \
-d '{"temperature":25,"humidity":"60"}'

##### Telemetry Plugin插件扩展
当涉及到复杂业务逻辑时还可以编写自定义Telemetry Processing Plugins来监听特定事件触发条件下的动作执行，比如每当接收到新消息就自动更新某些关联对象上的指定字段内容等等。