GetGroup
更新時間 2024-10-11 17:33:37
最近更新時間: 2024-10-11 17:33:37
分享文章
本節主要介紹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用戶組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>
