Disable Device¶
禁用设备。
操作权限¶
需授权的资源 |
所需操作权限 |
---|---|
设备管理 |
Full Access |
请求格式¶
POST https://{apigw-address}/connect-service/v2.1/devices?action=disable
请求参数(URI)¶
备注
以下非必须字段中,必须提供 assetId
或 productKey
+ deviceKey
的组合,用于指定设备。
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
必需 |
String |
资产所属的组织ID。 如何获取orgId信息>> |
assetId |
Query |
可选 |
String |
资产ID。 如何获取Asset ID信息>> |
productKey |
Query |
可选 |
String |
设备的Product Key。 |
deviceKey |
Query |
可选 |
String |
设备的Device Key。 |
错误码¶
代码 |
错误信息 |
描述 |
---|---|---|
11794 |
Device status is invalid |
要禁止的设备已处于禁用状态。 |
示例 1¶
请求示例¶
url:https://{apigw-address}/connect-service/v2.1/devices?action=disable&orgId=yourOrgId&assetId=yourAssetId
method: POST
返回示例¶
{
"code": 0,
"msg": "OK",
"requestId": "b3f22f9b-d90d-4bf2-9e97-79162a3d1dff",
"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.DisableDeviceRequest;
import com.envisioniot.enos.connect_service.v2_1.device.DisableDeviceResponse;
public class DisableDevice {
public static void main(String[] args) {
final String appKey = "yourAppKey";
final String appSecret = "yourAppSecret";
String serverUrl = "yourServerUrl";
String orgId = "yourOrgId";
String assetId = "yourAssetId";
DisableDeviceRequest request = new DisableDeviceRequest();
request.setOrgId(orgId);
request.setAssetId(assetId);
DisableDeviceResponse response = Poseidon.config(PConfig.init().appKey(appKey).appSecret(appSecret).debug())
.url(serverUrl)
.getResponse(request, DisableDeviceResponse.class);
}
}