调用该接口批量删除指定分组中的设备。(只删除设备与分组的关联关系,不会删除设备本身。)

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作。取值:BatchDeleteDeviceGroupRelations
GroupId String 分组ID,分组的全局唯一标识符。
Devices List<Device> 要从分组中删除的设备信息,请参见下表Device。
IotInstanceId String 公共实例不传此参数;仅独享实例需传入实例ID。
公共请求参数 - 请参见公共参数
表 1. Device
名称 类型 是否必需 描述
ProductKey String 要从分组中删除的设备所属的产品Key。
DeviceName String 要从分组中删除的的设备名称。

返回参数

名称 类型 描述
ValidDeviceCount Integer 请求参数中要删除的设备中,有效的设备数量(即可删除的设备数量)。
SuccessDeviceCount Integer 成功从分组中删除的设备数量。
AlreadyRelatedGroupDeviceCount Integer 删除前,已添加到此分组的设备数量。
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean​ 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 返回错误码,请参见错误码

示例

请求示例

http://iot.cn-shanghai.aliyuncs.com/?Action=BatchDeleteDeviceGroupRelations
&Device.1.DeviceName=ZHuPo6sZzv7pOzYh****
&Device.1.ProductKey=a1kORrK****
&Device.2.DeviceName=rB4V9PDW2FCPmwuf****
&Device.2.ProductKey=a1kORrK****
&GroupId=W16X8Tvdosec****
&公共请求参数

返回示例

  • JSON格式
    {
        "SuccessDeviceCount":2,
        "ValidDeviceCount":2,
        "AlreadyRelatedGroupDeviceCount":2,
        "RequestId":"8739385E-143F-4389-B900-B7DF9174CE0D",
        "Success":true    
    }
  • XML格式
    <?xml version="1.0" encoding="UTF-8" ?>
    <BatchDeleteDeviceGroupRelationsResponse>
        <SuccessDeviceCount>2</SuccessDeviceCount>
        <ValidDeviceCount>2</ValidDeviceCount>
        <AlreadyRelatedGroupDeviceCount>2</AlreadyRelatedGroupDeviceCount>
        <RequestId>8739385E-143F-4389-B900-B7DF9174CE0D</RequestId>
        <Success>true</Success>
    </BatchDeleteDeviceGroupRelationsResponse>