调用CreateUserGroup新建用户组_智能商业分析 Quick BI(Quick BI)-阿里云帮助中心

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

调试

当前API暂无授权信息透出。

名称	类型	必填	描述	示例值
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	Instance.Expired	Your instance has expired.	您的购买实例已经过期。
400	Instance.Not.Exist	The specified instance does not exist.	暂未匹配到您的购买实例。
400	Access.Forbidden	Access forbidden. Your instance version or access key is not allowed to call the API operation.	-
400	Invalid.Organization	The specified organizational unit does not exist.	该组织不存在。
400	User.Not.In.Organization	The specified user is not in the organizational unit.	该用户不在组织中。
400	Invalid.Parameter	An error occurred while verifying parameters.	参数验证失败。
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.	重复的用户组ID %s。
400	Invalid.Parameter.Error	The parameter is invalid:%s.	无效参数%s。
400	Internal.System.Error	An internal system error occurred.	系统内部异常。

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

变更时间	变更内容概要	操作
2023-06-20	OpenAPI 错误码发生变更	查看变更详情
2023-05-10	OpenAPI 错误码发生变更	查看变更详情