删除指定设备,一次最多删除20个。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DeleteDevices

系统规定参数。取值:DeleteDevices

DeviceIdList String 128290****,918888****

设备ID列表,多个之间用逗号分隔。

如果删除NVR或者ABOX,其下属通道也将同步删除,如果删除通道失败,则该设备删除失败。

最多支持20个设备。

返回数据

名称 类型 示例值 描述
RequestId String 46329898-489C-4E63-9BA1-C1DA5C5D0986

请求ID

Code String 200

返回结果编码

Message String Success

返回结果消息

Data Array of DeviceInfo

返回数据

DeviceId String a128290019999188288****

删除的设备编码

Code String 200

删除的状态码,取值范围:

  • 200
  • DeviceNotFound
  • InstanceAlreadyBind
  • DeviceDeleteError
  • SystemError
Description String SUCCESS

状态的描述,取值范围(和Code一一对应):

  • SUCCESS
  • The relevant device information could not be found
  • Device is already bound to an instance and cannot be deleted
  • Failed to delete device
  • Equipment is in operation, please hold on

示例

请求示例

http(s)://[Endpoint]/?Action=DeleteDevices
&DeviceIdList=128290****,918888****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteDevicesResponse>
    <RequestId>46329898-489C-4E63-9BA1-C1DA5C5D0986</RequestId>
    <Code>200</Code>
    <Message>Success</Message>
    <Data>
        <DeviceId>a128290019999188288****</DeviceId>
        <Code>200</Code>
        <Description>SUCCESS</Description>
    </Data>
</DeleteDevicesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
  "Code" : "200",
  "Message" : "Success",
  "Data" : [ {
    "DeviceId" : "a128290019999188288****",
    "Code" : "200",
    "Description" : "SUCCESS"
  } ]
}

错误码

访问错误中心查看更多错误码。