调用该接口添加设备到某一分组(可批量添加设备)。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作。取值:BatchAddDeviceGroupRelations
GroupId String 分组ID,分组的全局唯一标识符。
Devices List<Device> 要添加到分组的设备信息,请参见下表Device。
公共请求参数 - 请参见公共参数
表 1. Device
名称 类型 是否必需 描述
ProductKey String 要添加到分组的设备所属的产品Key。
DeviceName String 要添加到分组的设备名称。

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示调用是否成功。true表示调用成功,false表示调用失败。
ErrorMessage String 返回的结果信息。
Code String 返回错误码,请参见错误码
ValidDeviceCount Integer 请求参数中合法的设备数量。
SuccessAddedDeviceCount Integer 成功添加到分组的设备数量。
ExceedMaxGroupDeviceCount Integer 请求参数中,已经添加到10个或者10个以上分组的设备数量(一个设备最多添加到10个分组)。
AlreadyRelatedGroupDeviceCount Integer 原已经添加到此分组的设备数量。

示例

请求示例

http://iot.cn-shanghai.aliyuncs.com/?Action=BatchAddDeviceGroupRelations
&Device.1.DeviceName=ZHuPo6sZzv7pOzYhv31y
&Device.1.ProductKey=a1kORrKiwQj
&Device.2.DeviceName=rB4V9PDW2FCPmwuf2N3Y
&Device.2.ProductKey=a1kORrKiwQj
&GroupId=6VfhebLg5iUerXep
&公共请求参数

返回示例

{
    "SuccessAddedDeviceCount":2,
    "ExceedTenGroupDeviceCount":0,
    "ErrorMessage":"2 devices have been added, and 0 devices failed to be added.",
    "ValidDeviceCount":2,
    "AlreadyRelatedGroupDeviceCount":0,
    "RequestId":"671D0F8F-FDC7-4B12-93FA-336C079C965A",
    "Success":true   
}