CreateUserGroup - 新建用户组 - 智能商业分析 Quick BI

新建用户组，可以指定父用户组。

调试

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

quickbi-public:CreateUserGroup

create

*全部资源

*

无

名称	类型	必填	描述	示例值
UserGroupId	string	否	用户组唯一 ID。无需传入，系统会自动生成；当用户主动传入 UserGroupId 时，以用户传入的 ID 作为用户组 ID，用户需要自行保证该 ID 在组织内唯一。格式校验：最大长度 64，不能为-1，	pop0001
UserGroupName	string	是	用户组名称。格式校验：最大长度 255 特殊格式校验：中英文数字 _ \ / \| () ] [	杭州财报
UserGroupDescription	string	否	用户组描述。格式校验：最大长度 255 特殊格式校验：中英文数字 _ \ / \| () ] [	用户分组描述
ParentUserGroupId	string	是	父用户组 ID。可以将新建的用户组添加到该分组下：当输入父用户组 ID 时，新建的用户组会添加到该 ID 的用户组下。当输入-1 时，新建的用户组会添加到根目录下。	3d2c23d4-2b41-4af8-a1f5-f6390f32****

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	36829379-0C38-5BC0-830A-92665BF77D4F
Result	string	返回用户组添加成功后的 ID。如果添加失败，返回空字符串“”。	f5eeb52e-d9c2-4a8b-80e3-47ab55c2****
Success	boolean	是否请求成功。取值范围： true：请求成功 false：请求失败	true

正常返回示例

JSON格式

{
  "RequestId": "36829379-0C38-5BC0-830A-92665BF77D4F",
  "Result": "f5eeb52e-d9c2-4a8b-80e3-47ab55c2****",
  "Success": true
}

HTTP status code	错误码	错误信息
400	Usergroup.Not.Exist	The user group does not exist.
400	Duplicate.Name.Error	The name already exists.
400	UserGroup.Parent.NotFound	The parent user group does not exist.
400	Duplicate.UserGroup.Id	Duplicated usergroupId %s.
400	RootUserGroup.Create.Error	organization %s has synchronized with other organizational structures, so user groups cannot be created under the root user group.
400	UserGroup.Already.Synchronized	Organization has synchronized with other organizational structures, so you are not allowed to add users under group.
400	UserGroup.Layer.Limited	The user group cannot have more than ten layers.
400	UserGroup.ExceedsLimit.Error	User group exceed limit, %s.
400	Duplicate.UserGroupName.Error	There is already a user group with the same name %s, please rename it before saving.

访问错误中心查看更多错误码。

更多信息，参考变更详情。