CreateUserGroup
创建堡垒机用户组
服务地址:
华东1(杭州)
输入参数
只看必填
InstanceId要新建用户组的堡垒机实例的ID
RegionId要新建用户组的堡垒机的地域ID
UserGroupName要新建的用户组的名称
Comment新建的用户组的备注信息
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

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

请求参数

字段名称字段详情
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
变更历史
暂无变更历史