GetGroup
更新时间 2026-05-25 17:48:07
最近更新时间: 2026-05-25 17:48:07
本节主要介绍GetGroup。
此操作用来获取指定IAM用户组及组内IAM用户列表。
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Action | GetGroup。 | 是 |
| Version | 请求版本。 取值 ：2010-05-08。默认值为2010-05-08。 |
否 |
| GroupName | IAM用户组名。 类型 ：字符串 取值 ：1~128个字符组成，字符只能包含字母、数字或特殊字符。字母不区分大小写，特殊字符只能是：下划线_、中划线（-）、逗号（,）、句点（.）、加号（+）、等号（=）和at符号（@）。 |
是 |
| Marker | 分页标识。还有需要返回的用户时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 |
否 |
| MaxItems | 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整型 取值 ：1~1000，默认值为100。 |
否 |
响应结果
名称 描述 IsTruncated 用户是否已经都返回：
true：有未返回的用户。
false：已经返回所有的用户。
Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 Users.member.PasswordLastUsed 上次使用用户密码登录OOS网站时间，采用ISO 8601日期时间格式。
说明
如果从未使用密码登录，不返回此字段。
如果用户当前没有密码，但过去有密码，则此字段包含最近使用密码的时间。
Users.member.UserName IAM用户名。 Users.member.Arn IAM用户的资源名称。 Users.member.UserId IAM用户ID。 Users.member.CreateDate IAM用户创建时间。 Users.member.JoinDate IAM用户加入该用户组的时间。 Group.GroupName IAM用户组名。 Group.Arn IAM用户组的资源名称。 Group.GroupId IAM用户组ID。 Group.CreateDate IAM用户组创建的时间。
请求示例
获取指定IAM用户组group-read中的IAM用户列表。
POST / HTTP/1.1
Authorization: SignatureValue
x-amz-date: 20260520T013159Z
x-amz-content-sha256: UNSIGNED-PAYLOAD
Content-Type: application/octet-stream
Content-Length: 112
Host:oos-cn-iam.ctyunapi.cn
Action=GetGroup&Version=2010-05-08&GroupName=group-read&Marker=user|32fefj64y54gc|group-read|iamuser1&MaxItems=2
响应示例
HTTP/1.1 200 OK
x-amz-request-id: 89d1e4404d4244fc
Content-Type: application/xml;charset=UTF-8
Content-Length: 910
Date: Wed, 20 May 2026 01:31:59 GMT
Server: CTYUN
<GetGroupResponse>
<GetGroupResult>
<Group>
<GroupId>13f64b8e4e844aa08fbab54d6338206d</GroupId>
<GroupName>group-read</GroupName>
<CreateDate>2023-07-11T07:38:50Z</CreateDate>
<Arn>arn:ctyun:iam::32fefj64y54gc:group/group-read</Arn>
</Group>
<Users>
<member>
<UserId>1e0828eec2b343f686ed041f334798b8</UserId>
<UserName>test-aa</UserName>
<Arn>arn:ctyun:iam::32fefj64y54gc:user/test-aa</Arn>
<JoinDate>2023-12-10T10:00:49Z</JoinDate>
<CreateDate>2023-12-10T10:00:48Z</CreateDate>
</member>
<member>
<UserId>0e05cb8e6b1749be882b50ff80a4d54a</UserId>
<UserName>test_a1</UserName>
<Arn>arn:ctyun:iam::32fefj64y54gc:user/test_a1</Arn>
<JoinDate>2023-09-14T07:08:39Z</JoinDate>
<CreateDate>2023-09-14T07:08:38Z</CreateDate>
</member>
</Users>
<IsTruncated>true</IsTruncated>
<Marker>user|32fefj64y54gc|group-read|test_a1</Marker>
</GetGroupResult>
<ResponseMetadata>
<RequestId>89d1e4404d4244fc</RequestId>
</ResponseMetadata>
</GetGroupResponse>
