ListGroups
更新時間 2024-09-19 16:53:52
最近更新時間: 2024-09-19 16:53:52
分享文章
本節主要介紹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 用戶組是否已經都返回：
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>
