V2.1 Delete Device


删除设备。

该 API 支持在 EnOS 2.1.0 及以上环境中使用。

操作权限


使用此 API 前,确保服务账号已被授予包含下列服务和操作权限的策略。有关授权服务账号的更多信息,参见 管理服务账号


需授权的服务 所需操作权限
设备管理服务 Full Access

请求格式

POST https://{apigw-address}/connect-service/v2.1/devices?action=delete

请求参数(URI)

注解

以下非必需字段中,必须提供 assetIdproductKey + deviceKey 的组合,用于指定设备。

名称 位置(Path/Query) 必需/可选 数据类型 描述
orgId Query 必需 String 资产所属的组织 ID。如何获取 orgId 信息>>
assetId Query 可选(见上述注解) String 资产ID。如何获取 assetId 信息>>
productKey Query 可选(见上述注解) String 设备的 product key,需与 deviceKey 一起使用。
deviceKey Query 可选(见上述注解) String 设备的 device key,需与 productKey 一起使用。

错误码

代码 错误信息 描述
11404 Device cannot be found 用于指定设备的 assetIdproductKeydeviceKey 不存在。

示例

请求示例

url:https://{apigw-address}/connect-service/v2.1/devices?action=delete&orgId=yourOrgId&assetId=yourAssetId
method: POST

返回示例

responseBody:{
"code":0,
"msg":"OK",
"requestId":"12d7e3be-6bac-43de-8733-7e02a4eb8a88",
"data":null
}

SDK 示例


你可以在 Github 上获取接入服务的 SDK 示例: