V2.1 Disable Device


禁用设备。

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

操作权限


确保已获取调用该 API 的权限。更多信息,参见 获取 API 调用权限

请求格式

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

请求参数(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 一起使用。如何获取设备的三元组信息>>

错误码

代码

错误信息

描述

11723

Device is disabled

要禁用的设备已处于禁用状态。

示例

请求示例

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
}

SDK 示例


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