此操作用来列出所有的IAM用户组。
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Action | ListGroups。 | 是 |
| Version | 请求版本。 取值 ：2010-05-08。默认值为2010-05-08。 |
否 |
| GroupName | 指定IAM用户组名。在此操作中进行用户组模糊匹配查询，例如指定GroupName为test，凡是包含test的用户组都会返回。 类型 ：字符串 取值 ：1~128个字符组成，字符只能包含字母、数字或特殊字符。字母不区分大小写，特殊字符只能是：下划线（_）、中划线（-）、逗号（,）、句点（.）、加号（+）、等号（=）和at符号（@）。 |
否 |
| Marker | 分页标识。还有需要返回的用户组时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型 ：字符串 取值 ：与上条响应中返回的结果值相同。 |
否 |
| MaxItems | 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示还有未返回项。查看未显示的项时，需要携带响应参数Marker的值。 类型 ：整型 取值 ：1~1000，默认值为100。 |
否 |
响应结果
名称 描述 IsTruncated 用户组是否已经都返回：
true：有未返回的用户组。
false：已经返回所有的用户组。
Marker 分页标识。当IsTruncated是true时，该项存在，其值用于下一次请求的参数Marker的取值。 Groups.memeber.GroupName IAM用户组的名称。 Groups.memeber.Arn IAM用户的资源名称。 Groups.memeber.GroupID IAM用户组的ID。 Groups.memeber.CreateDate IAM用户组创建的时间。 Groups.memeber.Policies IAM用户组关联的策略个数。 Groups.memeber.Users IAM用户组中用户的个数。
请求示例
列出所有的用户组，每次最多返回2组。
POST / HTTP/1.1
Host:oos-cn-iam.ctyunapi.cn
x-amz-content-sha256: UNSIGNED-PAYLOAD
Authorization: SignatureValue
X-Amz-Date: 20190130T072355Z
Content-type: application/octet-stream
Action=ListGroups&Version=2010-05-08&MaxItems=2
响应示例
HTTP/1.1 200 OK
x-amz-request-id:1d1089f15291424a
Content-Type:text/xml;charset=UTF-8
Content-Length:28798
Date:Wed, 30 Jan 2019 07:23:55 GMT
Server: CTYUN
<ListGroupsResponse>
<ListGroupsResult>
<IsTruncated>true</IsTruncated>
<Groups>
<member>
<GroupName>PM</GroupName>
<Arn>arn:ctyun:iam::10rc2arpn6306:group/PM</Arn>
<GroupId>514648bfbc4e423f867a25281642cdfc</GroupId>
<CreateDate>2012-07-30T01:01:37Z</CreateDate>
<Policies>10</Policies>
<Users>10</Users>
</member>
<member>
<GroupName>test_group</GroupName>
<Arn>arn:ctyun:iam::10rc2arpn6306:group/test_group</Arn>
<GroupId>614648bfbc4e423f867a25281642cdfc</GroupId>
<CreateDate>2019-01-07T05:39:03Z</CreateDate>
<Policies>10</Policies>
<Users>10</Users>
</member>
</Groups>
<Marker>10rc2arpn6306|test_group</Marker>
</ListGroupsResult>
<ResponseMetadata>
<RequestId>1d1089f15291424a</RequestId>
</ResponseMetadata>
</ListGroupsResponse>
