设备接入 IoTDA设备接入 IoTDA

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

删除设备

接口说明

应用服务器可调用此接口删除设备,设备下线时需要删除该设备。

URI

请求方法

DELETE

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,访问其他应用所持有的资源时需要填写。

cascade

可选

Boolean

Query

  • true,级联删除,即删除设备以及设备下的子设备。
  • false,删除设备,但是不删除设备下的子设备。

请求示例

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

响应示例

Status Code: 200 OK

错误码

HTTP状态码

HTTP状态码说明

错误码

错误码描述

200

OK

-

-

401

Unauthorized

100002

Invalid access token.

处理建议:获取token失败,重新登录获取token信息。

403

Forbidden

100203

The application does not exist.

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

100217

The application hasn't been authorized.

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

404

Not Found

100418

The deviceData is not existed.

处理建议:设备已被删除,不需要再进行删除操作。

分享:

    相关文档

    相关产品