设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

修改设备信息

接口说明

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

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.

分享:

    相关文档

    相关产品