设备的部分信息，如厂商、设备型号等，可以作为设备标签上报。

标签信息上报

上行。

  • 请求Topic：/sys/{productKey}/{deviceName}/thing/deviceinfo/update
  • 响应Topic：/sys/{productKey}/{deviceName}/thing/deviceinfo/update_reply

Alink请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": [
    {
      "attrKey": "Temperature",
      "attrValue": "36.8"
    }
  ],
  "method": "thing.deviceinfo.update"
}

Alink响应数据格式：

{
  "id": "123",
  "code": 200,
  "data": {}
}

参数说明：

参数 类型 说明
id String 消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
version String 协议版本号，目前协议版本号唯一取值为1.0。
sys Object 扩展功能的参数，其下包含各功能字段。
说明 使用设备端SDK开发时，如果未设置扩展功能，则无此参数，相关功能保持默认配置。
ack Integer sys下的扩展功能字段，表示是否返回响应数据。
  • 1：云端返回响应数据。
  • 0：云端不返回响应数据。
说明 该功能配置说明，请参见物模型编程。

如果未配置该功能，则无此参数，云端默认返回响应数据。
params Object

请求参数，包含标签的键attrKey和值attrValue。

params元素个数不超过200个。
method String 请求方法，取值thing.deviceinfo.update。
attrKey String 标签Key。可包含英文字母、数字、下划线（_）、短划线（-）、井号（#）、at（@）、百分号（%）、and（&）、星号（*）和点号（.），长度不超过30个字符。
attrValue String 标签的值。可包含中文、英文字母、数字、日文、下划线（_）和短划线（-）、井号（#）、at（@）、百分号（%）、and（&）、英文冒号（:）和点号（.），长度不超过128个字符，一个中文或日文占2个字符。
code Integer 结果信息，200表示成功。

错误码：

错误码 消息 描述
460 request parameter error 请求参数错误。
6100 device not found 设备不存在。

删除标签信息

上行。

  • 请求Topic：/sys/{productKey}/{deviceName}/thing/deviceinfo/delete
  • 响应Topic：/sys/{productKey}/{deviceName}/thing/deviceinfo/delete_reply

Alink请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": [
    {
      "attrKey": "Temperature"
    }
  ],
  "method": "thing.deviceinfo.delete"
}

Alink响应数据格式：

{
  "id": "123",
  "code": 200,
  "data": {}
}

参数说明：

参数 类型 说明
id String 消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
version String 协议版本号，目前协议版本号唯一取值为1.0。
sys Object 扩展功能的参数，其下包含各功能字段。
说明 使用设备端SDK开发时，如果未设置扩展功能，则无此参数，相关功能保持默认配置。
ack Integer sys下的扩展功能字段，表示是否返回响应数据。
  • 1：云端返回响应数据。
  • 0：云端不返回响应数据。
说明 该功能配置说明，请参见物模型编程。

如果未配置该功能，则无此参数，云端默认返回响应数据。
params Object 请求参数，包含要删除的标签键attrKey参数。
method String 请求方法，取值thing.deviceinfo.delete。
attrKey String 要删除标签的Key。
code Integer 结果信息，200表示成功。

错误码：

错误码 消息 描述
460 request parameter error 请求参数错误。
6100 device not found 设备不存在。