Delete Device¶
删除设备。
操作权限¶
需授权的资源 | 所需操作权限 |
---|---|
设备管理 | Full Access |
请求格式¶
POST https://{apigw-address}/connect-service/v2.1/devices?action=delete
请求参数(URI)¶
注解
以下非必须字段中,必须提供 assetId
或 productKey
+ 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 | 用于指定设备的 assetId 、productKey 或 deviceKey 不存在。 |
示例¶
请求示例¶
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
}
Java SDK调用示例¶
package com.envisioniot.enos.api.sample.connect_service.device;
import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envisioniot.enos.connect_service.v2_1.device.DeleteDeviceRequest;
import com.envisioniot.enos.connect_service.v2_1.device.DeleteDeviceResponse;
public class DeleteDevice {
public static void main(String[] args) {
final String appKey = "yourAppKey";
final String appSecret = "yourAppSecret";
String serverUrl = "yourServerUrl";
String orgId = "yourOrgId";
String assetId = "yourAssetId";
DeleteDeviceRequest request = new DeleteDeviceRequest();
request.setOrgId(orgId);
request.setAssetId(assetId);
DeleteDeviceResponse response = Poseidon.config(PConfig.init().appKey(appKey).appSecret(appSecret).debug())
.url(serverUrl)
.getResponse(request,DeleteDeviceResponse.class);
}
}