CreateUserGroup_运维安全中心（堡垒机）_API文档-阿里云OpenAPI开发者门户

接口说明

本接口用于为堡垒机创建用户组。堡垒机管理员可使用本接口创建用户组，然后使用 AddUsersToGroup 接口为该用户组批量添加用户。将用户添加到同一个用户组，可实现对堡垒机用户的统一授权和管理。

本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

yundun-bastionhost:CreateUserGroup	Create	全部资源 *	无	无

字段名称	字段详情
InstanceIdstring	要新建用户组的堡垒机实例的 ID。展开详情示例值:bastionhost-cn-st220aw****参考取值来源: StartInstance DescribeInstances ConfigInstanceWhiteList EnableInstancePublicAccess DisableInstancePublicAccess
RegionIdstring	要新建用户组的堡垒机的地域 ID。展开详情示例值:cn-hangzhou参考取值来源: DescribeRegions
UserGroupNamestring	要新建的用户组的名称。最多支持 128 字符。示例值:group参考取值来源: GetUserGroup ListUserGroups
Commentstring	新建的用户组的备注信息。最多支持 500 字符。示例值:comment

调用 API 时，除了本文中该 API 的请求参数，还需加入阿里云 API 公共请求参数。公共请求参数的详细介绍，请参见公共参数。调用 API 的请求格式，请参见本文示例中的请求示例。

字段名称	字段详情
UserGroupIdstring	新建的用户组的 ID。示例值:1
RequestIdstring	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。示例值:EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

没有我想要的错误码, 点击反馈

HTTP 状态码	错误码	错误信息	操作

400	InvalidParameter	The argument is invalid.	诊断
400	UserGroupAlreadyExists	The user group already exists.	诊断
500	InternalError	An unknown error occurred.	诊断

暂无变更历史