此操作用来获取指定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用户组test_group中的IAM用户列表。
POST / HTTP/1.1
Host:oos-cn-iam.ctyunapi.cn
x-amz-content-sha256: UNSIGNED-PAYLOAD
Authorization: SignatureValue
X-Amz-Date: 20190130T065257Z
Content-type: application/octet-stream
Action=GetGroup&Version=2010-05-08&GroupName=test_group
响应示例
HTTP/1.1 200 OK
x-amz-request-id:eaa7820a93344169
Content-Type:text/xml;charset=UTF-8
Content-Length:1098
Date:Wed, 30 Jan 2019 06:52:57 GMT
Server: CTYUN
<GetGroupResponse>
<GetGroupResult>
<IsTruncated>false</IsTruncated>
<Users>
<member>
<PasswordLastUsed>2019-01-07T05:57:35Z</PasswordLastUsed>
<UserName>test1</UserName>
<Arn>arn:ctyun:iam::10rc2arpn6306:user/test1</Arn>
<UserId>623387e786314d3f973359c9de61a39d</UserId>
<CreateDate>2019-01-07T05:53:20Z</CreateDate>
<JoinDate>2019-01-10T05:53:20Z</JoinDate>
</member>
<member>
<UserName>test2</UserName>
<Arn>arn:ctyun:iam::10rc2arpn6306:user/test2</Arn>
<UserId>723387e786314d3f973359c9de61a39d</UserId>
<CreateDate>2015-09-21T07:20:12Z</CreateDate>
<PasswordLastUsed>2019-07-15T01:18:21Z</PasswordLastUsed>
<JoinDate>2019-01-10T05:53:20Z</JoinDate>
</member>
</Users>
<Group>
<GroupName>test_group</GroupName>
<Arn>arn:ctyun:iam::10rc2arpn6306:group/test</Arn>
<GroupId>514648bfbc4e423f867a25281642cdfc</GroupId>
<CreateDate>2019-01-07T05:39:03Z</CreateDate>
</Group>
</GetGroupResult>
<ResponseMetadata>
<RequestId>eaa7820a93344169</RequestId>
</ResponseMetadata>
</GetGroupResponse>