ListGroupForUser
更新时间 2026-05-25 17:48:03
最近更新时间: 2026-05-25 17:48:03
本节主要介绍 ListGroupForUser。
此操作用来列出指定IAM用户所属的IAM用户组。
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Action | ListGroupsForUser。 | 是 |
| Version | 请求版本。 取值 ：2010-05-08。默认值为2010-05-08。 |
否 |
| UserName | IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（_）、中划线（-）、逗号（,）、句点（.）、加号（+）、等号（=）和at符号（@）。 |
是 |
| Marker | 分页标识。还有需要返回的用户组时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 |
否 |
| MaxItems | 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整数类型 取值 ：1~1000，默认值为100。 |
否 |
响应结果
名称 描述 Groups.member.GroupName IAM用户组名。 Groups.member.GroupId IAM用户组ID。 Groups.member.Arn IAM用户组的资源名称。 Groups.member.CreateDate IAM用户组创建的时间。 IsTruncated 用户组是否已经都返回：
true：有未返回的用户组。
false：已经返回所有的用户组。
Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。
请求示例
列出IAM用户test所属的IAM用户组。
POST / HTTP/1.1
Authorization: signatureValue
x-amz-date: 20260518T083938Z
x-amz-content-sha256: UNSIGNED-PAYLOAD
Content-Type: application/octet-stream
Content-Length: 108
Host: oos-cn-iam.ctyunapi.cn
Action=ListGroupsForUser&Version=2010-05-08&UserName=test&MaxItems=2&Marker=group|32fefj64y54gc|test|groupte
响应示例
HTTP/1.1 200 OK
x-amz-request-id: 6710251d98ac4ab6
Content-Type: text/xml
Content-Length: 664
Date: Mon, 18 May 2026 08:39:38 GMT
Server: CTYUN
<ListGroupsForUserResponse>
<ListGroupsForUserResult>
<Groups>
<member>
<GroupId>8efe4f58f1174673b029087f29fb89ca</GroupId>
<GroupName>oos-read</GroupName>
<CreateDate>2020-05-13T06:48:03Z</CreateDate>
<Arn>arn:ctyun:iam::32fefj64y54gc:group/oos-read</Arn>
</member>
<member>
<GroupId>d801b1e6c5724ce69d37d9b33639a0dc</GroupId>
<GroupName>test</GroupName>
<CreateDate>2023-07-10T03:20:05Z</CreateDate>
<Arn>arn:ctyun:iam::32fefj64y54gc:group/test</Arn>
</member>
</Groups>
<IsTruncated>true</IsTruncated>
<Marker>group|32fefj64y54gc|test|test</Marker>
</ListGroupsForUserResult>
<ResponseMetadata>
<RequestId>6710251d98ac4ab6</RequestId>
</ResponseMetadata>
</ListGroupsForUserResponse>
