Call the ListUserGroups API to query user groups - Bastionhost - Alibaba Cloud - Bastionhost

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	The ID of the bastion host on which you want to query user groups. Note You can call the DescribeInstances operation to query the ID of the bastion host.	bastionhost-cn-st220aw****
RegionId	string	No	The region ID of the bastion host on which you want to query user groups. Note For more information about the mapping between region IDs and region names, see Regions and zones.	cn-hangzhou
PageNumber	string	No	The number of the page to return. Default value: 1.	1
PageSize	string	No	The number of entries to return on each page. Maximum value: 100. Default value: 20. If you leave this parameter empty, 20 entries are returned on each page.	20
UserGroupName	string	No	The name of the user group that you want to query. Only exact match is supported.	TestGroup01

When you call this API operation, you must include the common request parameters of Alibaba Cloud API in your request in addition to the request parameters described in this topic. For more information about common request parameters, see Common parameters. For the request format, see the request examples in this topic.

Response elements

Element	Type	Description	Example
	object	The response data.
TotalCount	integer	The total number of user groups returned.	1
RequestId	string	The ID of the request.	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
UserGroups	array<object>	The user groups returned.
	object
UserGroupName	string	The name of the user group.	TestGroup01
MemberCount	integer	The number of users in the user group.	6
Comment	string	The description of the user group.	comment
UserGroupId	string	The ID of the user group.	1

Examples

Success response

JSON format

{
  "TotalCount": 1,
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "UserGroups": [
    {
      "UserGroupName": "TestGroup01",
      "MemberCount": 6,
      "Comment": "comment",
      "UserGroupId": "1"
    }
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter	The argument is invalid.	The argument is invalid.
500	InternalError	An unknown error occurred.	An unknown error occurred.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.