更新设备信息
更新设备的名称、说明和标签。
请求URL
PUT {base_url}/device/openapi/v1.0/devices
请求参数
参数 | 是否必填 | 类型 | 描述 |
---|---|---|---|
Authorization | 是 | String | API调用的有效访问token。 格式为 Bearer {access_token}。 |
参数 | 是否必填 | 类型 | 描述 |
---|---|---|---|
deviceId | 是 | Integer | 设备的唯一标识符,当您添加设备时会返回。 注: 如果您没有保存设备ID,可以使用以下方法查询设备的ID
查询设备列表。
|
name | 是 | String | 更新设备名称。 |
description | 否 | String | 更新设备说明。 |
project | 否 | String | 更新设备标签。 |
响应参数
参数 | 类型 | 描述 |
---|---|---|
data | Object<Device_Info> | 更新后的设备信息。 |
status | String | API的请求结果。
|
requestId | String | 唯一的请求ID ,可用于快速定位请求。 |
- 设备信息
-
参数 类型 描述 String 设备的SN(序列号)。 deviceId Integer 在星纵物联开放平台上设备唯一的ID。 注: 建议保存此设备ID以备未来使用,因为它通过API管理或配置设备时是必需的要填入的。devEUI String 注: 根据产品型号的不同,此参数可能不会被返回。EUI(设备的唯一标识符)。imei String 注: 根据产品型号的不同,此参数可能不会被返回。设备IMEI(国际移动设备识别码)号
示例
- 请求示例
- 更新ID为"1742010610312101890"的设备的名称和标签。
- 响应示例
-
HTTP/1.1 200 OK { "data": { "sn": "6785C38073640023", "deviceId": "1742010610312101890", }, "status": "Success", "requestId": "f3f81c188c03c4b098a83503109802d2" }