CreateGroup

Last Updated At: 2026-08-02 00:04:54

1. Interface Description

Interface request domain name: cic.api3.convergecloud.com.

Create User Group

Default interface request rate limit: 20 times per second.

Interface update time: 2024-12-11 12:17:58.

The interface is both signature verification and authentication.

2. Input Parameters

The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.

Parameter name	Required	Allow NULL	Type	Description
Action	Yes	No	String	Public parameter, The value of this interface: CreateGroup
Version	Yes	No	String	Public parameter, The value of this interface: 2021-03-31
Region	No	No	String	Public parameter,Regional information This interface does not need to pass this parameter.
ZoneId	Yes	Yes	String	Space ID. Example: z-2d8shd8***
GroupName	Yes	Yes	String	User group name, which contains up to 128 characters, including English letters, digits, and special characters (-). Example: group_name
Description	No	Yes	String	User group description, which contains up to 1024 characters. Example: description
GroupType	No	Yes	String	User group type. Manual: manually created, Synchronized: imported from external sources. Example: Manual

3. Output Parameters

Parameter name	Type	Description
GroupInfo	GroupInfo	User group information. Example:View
RequestId	String	Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem.

4. Error Code

The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.

Error Code	Description
FailedOperation.IdentityCenterNotOpen
FailedOperation.ZoneIdNotExist
InvalidParameter.GroupNameFormatError
InvalidParameter.GroupNameAlreadyExists
FailedOperation.GroupOverUpperLimit