全部产品
Search
文档中心

运维安全中心(堡垒机):ListUserGroupsForUser - 获取用户加入的用户组列表

更新时间:Aug 14, 2026

获取用户加入的用户组列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

堡垒机实例的 ID。

说明

您可以调用 DescribeInstances 接口获取该参数。

bastionhost-cn-m413tuhlo03

RegionId

string

堡垒机的区域 ID。

说明

区域 ID 和区域名称的对应关系,请参见地域和可用区

cn-hangzhou

UserId

string

用户 ID。

1

PageNumber

string

指定分页查询时,当前页的页码。默认值为 1

1

PageSize

string

指定分页查询时,每页显示的数据最大条数。
PageSize 参数最大取值为 100。每页默认显示的数据条数为 20 条,PageSize 参数值为空时,将默认返回 20 条数据。

说明

建议 PageSize 取值不要为空。

20

Keyword

string

要查询的用户组名称。模糊查询。

test

PagingOff

string

指定是否分页查询。取值:

  • true:不分页,获取全部数据。

  • false:分页获取数据,每次获取 PageSize 取值数量的用户组。

true

ProjectId

integer

项目 ID

1

返回参数

名称

类型

描述

示例值

object

Count

integer

查询到的用户组总数。

12

RequestId

string

阿里云为该请求生成的唯一标识符。

EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

UserGroups

array<object>

用户组列表。

object

用户组列表。

UserGroupName

string

用户组名称。

group

Comment

string

用户组备注。

comment

UserGroupId

string

用户组 ID。

2

ProjectId

string

用户组所属项目的 ID。

2

ProjectName

string

用户组所属项目的名称。

test

示例

正常返回示例

JSON格式

{
  "Count": 12,
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "UserGroups": [
    {
      "UserGroupName": "group",
      "Comment": "comment",
      "UserGroupId": "2",
      "ProjectId": "2",
      "ProjectName": "test"
    }
  ]
}

错误码

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

变更历史

更多信息,参考变更详情