Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 设备接入应用侧API参考> 设备管理> 修改设备信息
View PDF

修改设备信息

接口说明

应用服务器可调用此接口修改设备信息，例如设备名称。

URI

请求方法

PATCH

URI

/api/v3.0/devices/{deviceId}

传输协议

HTTPS

请求参数

名称

必选/可选

类型

位置

说明

app_key

必选

String

Header

已鉴权应用的appId。

Authorization

必选

String

Header

请求的认证信息，值为“Bearer ******”，其中******为Auth鉴权接口返回的accessToken。

deviceId

必选

String

Path

设备ID。

ownerAppId

可选

String

Query

资源所属应用的appId，访问其他应用所持有的资源时需要填写。

name

可选

String(1-256)

Body

设备名称。

请求示例

PATCH https://{host}:{port}/api/v3.0/devices/{deviceId}?ownerAppId={ownerAppId}
Content-Type: application/json
app_key: ********
Authorization: ********

{
  "name" : "device2"
}

响应示例

Status Code: 200 OK

错误码

HTTP状态码

HTTP状态码说明

错误码

错误码描述

200

OK

100403

The device does not exist.

处理建议：设备已被删除或重新注册，可通过查询设备列表接口查询设备是否还在平台内。

100418

The deviceData is not existed.

处理建议：设备已被删除或重新注册，可通过查询设备列表接口查询设备是否还在平台内。

400

Bad Request

100007

Bad request message.

处理建议：入参错误，检查参数是否正确

100022

The input is invalid.

处理建议：入参错误，检查参数是否正确

401

Unauthorized

100002

Invalid access token.

处理建议：token无效，重新申请token。

403

Forbidden

100203

The application does not exist.

处理建议：检查并填写正确的appId。

100217

The application hasn't been authorized.

处理建议：应用没有被授权，检查该应用是否有权限。

500004

The amount of frozen devices has reached the limit.
父主题： 设备管理