文档简介：
ListGroups
此操作用来列出所有的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 |
用户组是否已经都返回：
|
|
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 Authorization:signatureValue X-Amz-Date:date 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> |
