获取用户组列表,可根据分页及名称关键字筛选符合要求的云堡垒机用户组列表,并且能够按字段进行排序。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListUserGroups | 接口名称。当前 API 的名称为 ListUserGroups 。 |
Version | String | 是 | 2021-06-01 | 接口版本。当前 API 的版本为 2021-06-01 。 |
PageNumber | Integer | 否 | 1 | 分页查询时的起始页码,从 1 开始,默认为 1。 |
PageSize | Integer | 否 | 10 | 分页查询时每页显示的记录数。
|
Filter | Object of ListUserGroupsFilter | 否 | {"Keyword": "职能组"} | 筛选条件。 |
OrderBy | Object of OrderBy | 否 | {"Key": "somekey", "Desc": true} | 排序信息。 |
InstanceId | String | 是 | "vbh-21****2257-6vcphcm8" | 云堡垒机 ID。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Keyword | String | 否 | keyword | 模糊搜索 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Key | String | 否 | key | 字段 |
Desc | Boolean | 否 | true or false | 倒序 |
POST https://vbh.{RegionID}.volcengineapi.com/?Action=ListUserGroups&Version=2021-06-01 Content-Type: application/json { "PageNumber": 1, "PageSize": 10, "Filter": { "Keyword": "职能组" }, "OrderBy": { "Key": "Name", "Desc": true }, "InstanceId": "vbh-21****2257-6vcphcm8" }
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Items | Array of UserGroupV2 | [{"CreateTime":"2022-08-10 12:34:24","UpdateTime":"2022-08-10 12:34:24","UserGroupName":"222","InstanceId":"vbh-1400000042-wxvqsx9f","UserGroupId":"749e74c0-e33e-4674-9a75-ecb832ae97db","Description":""}] | 用户组信息列表。 |
TotalCount | Long | 20 | 返回数据列表的总量。 |
PageNumber | Integer | 1 | 当前页号。 |
PageSize | Integer | 10 | 每页显示的数量。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
CreateTime | String | 2022-12-12 22:22:22 | 创建时间 |
UpdateTime | String | 2022-12-12 22:22:22 | 修改时间 |
UserGroupName | String | userGroup name | 用户组名称 |
InstanceId | String | instance id | 堡垒机 ID |
UserGroupId | String | userGroup id | 用户组 Id |
Description | String | some description | 描述 |
HTTP/1.1 200 OK Content-Type:application/json { "ResponseMetadata": { "RequestId": "202211302208****", "Action": "ListUserGroups", "Version": "2021-06-01", "Service": "vbh", "Region": "cn-beijing" }, "Result": { "Items": [ { "CreateTime": "2023-09-12 10:34:30", "UpdateTime": "2023-09-12 10:34:30", "UserGroupName": "职能组", "InstanceId": "vbh-14****0042-wdk****z", "UserGroupId": "6f7****0-d587-11ec-bae1-62******7e3", "Description": "This is some description" } ], "TotalCount": 20, "PageNumber": 2, "PageSize": 10 } }
当前接口暂无独立错误码,若接口调用返回异常,可参考 公共错误码 进行故障排查。