调用该接口新建分组。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作。取值:CreateDeviceGroup
SuperGroupId String 父组ID。

若要创建的是一级分组,则不传入此参数。

GroupName String 分组名称。名称可包含中文汉字、英文字母、数字和下划线(_)。长度范围 4 - 30 字符(一个中文汉字占二个字符)。
GroupDesc String 分组描述。长度限制为100字符(一个中文汉字占一个字符)。
IotInstanceId String 公共实例不传此参数;仅独享实例需传入实例ID。
公共请求参数 - 请参见公共参数

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 返回错误码,请参见错误码
Data Data 请参考下表Group。
表 1. Group
名称 类型 描述
GroupName String 分组名称。
UtcCreate Date 创建时间。
GroupDesc String 分组描述。
GroupId String 分组ID,系统为分组生成的全局唯一标识符。

示例

请求示例

http://iot.cn-shanghai.aliyuncs.com/?Action=CreateDeviceGroup
&GroupDesc=Group test
&GroupName=grouptest
&公共请求参数

返回示例

  • JSON格式
    {
        "Data":{
            "GroupDesc":"Group test",
            "GroupName":"grouptest",
            "UtcCreate":"2018-10-17T11:19:31.000Z",
            "GroupId":"HtMLECKbdJQL****"
        },
        "RequestId":"4D6D7F71-1C94-4160-8511-EFF4B8F0634D",
        "Success":true
    }
  • XML格式
    <?xml version="1.0" encoding="UTF-8" ?>
    <CreateDeviceGroupResponse>
        <Data>
            <GroupDesc>Group test</GroupDesc>
            <GroupName>grouptest</GroupName>
            <UtcCreate>2018-10-17T11:19:31.000Z</UtcCreate>
            <GroupId>HtMLECKbdJQL****</GroupId>
        </Data>
        <RequestId>4D6D7F71-1C94-4160-8511-EFF4B8F0634D</RequestId>
        <Success>true</Success>
    </CreateDeviceGroupResponse>