Call this operation to create a device group.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set the value to CreateDeviceGroup.
SuperGroupId String No The ID of the parent group.

If you want to create a first-level group, do not enter this parameter.

GroupName String Yes The name of the group. The name can contain Chinese characters, English letters, digits, and underscores (_). The length must be 4 to 30 characters (a Chinese character counts as two characters).
GroupDesc String No The description of the group. You can enter a description with up to 100 characters.
Common request parameters - Yes see Common parameters.

Response parameters

Parameter Type Description
RequestId String The globally unique ID generated by Alibaba Cloud for the request.
Success Boolean Indicates whether the call is successful. A value of true indicates that the call is successful. A value of false indicates that the call has failed.
ErrorMessage String The error message returned when the call fails. 
Code String For error codes, see Error codes.
Data Data See the following table Group.
Table 1. Group
Parameter Type Description
GroupName String The name of the group.
UtcCreate Date The time when the group is created.
GroupDesc String The description of the group.
GroupId String The group ID generated by the IoT platform. It is the unique identifier of the group.

Example

Request example

http://iot.cn-shanghai.aliyuncs.com/?Action=CreateDeviceGroup
&GroupDesc=Group test
&GroupName=grouptest
&Common request parameters

Response example

{
    "Data":{
        "GroupDesc":"Group test",
        "GroupName":"grouptest",
        "UtcCreate":"2018-10-17T11:19:31.000Z",
        "GroupId":"HtMLECKbdJQLIcbY"
    },
    "RequestId":"4D6D7F71-1C94-4160-8511-EFF4B8F0634D",
    "Success":true
}