Delete Device


删除设备。

操作权限

需授权的资源

所需操作权限

设备管理

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
}

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);

    }
}