设备的部分信息,如厂商、设备型号等,可以作为设备标签上报。
标签信息上报
上行。
- 请求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下的扩展功能字段,表示是否返回响应数据。
注意 该功能配置说明,请参见概述。
如果未配置该功能,则无此参数,云端默认返回响应数据。 |
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下的扩展功能字段,表示是否返回响应数据。
注意 该功能配置说明,请参见概述。
如果未配置该功能,则无此参数,云端默认返回响应数据。 |
params | Object | 请求参数,包含要删除的标签键attrKey参数。 |
method | String | 请求方法,取值thing.deviceinfo.delete 。
|
attrKey | String | 要删除标签的Key。 |
code | Integer | 结果信息,200表示成功。 |
错误码:
错误码 | 消息 | 描述 |
---|---|---|
460 | request parameter error | 请求参数错误。 |
6100 | device not found | 设备不存在。 |