ListUsers
更新時間 2024-10-11 17:33:36
最近更新時間: 2024-10-11 17:33:36
分享文章
本節主要介紹ListUsers。
此操作用來列出IAM用戶。如果賬戶中沒有創建IAM用戶，則返回空列表。
請求參數
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| Action | ListUsers。 | 是 |
| Version | 請求版本。 取值 ：2010-05-08。默認值為2010-05-08。 |
否 |
| Marker | 分頁標識。還有需要返回的用戶時，上條響應結果中會返回該參數。查看未顯示項時，請求參數中需要攜帶此參數。 類型 ：字符串 取值 ：與上條響應中返回的結果值相同。 |
否 |
| MaxItems | 設置響應中最多返回的條數。如果存在超出您指定的返回項，則IsTruncated響應元素為true，表示需要再次發送請求查看未顯示的項。查看未顯示的項時，需要攜帶響應參數Marker的值。 類型 ：整型 取值 ：1~1000，默認值為100。 |
否 |
| UserName | 查詢IAM用戶的用戶名，進行模糊匹配搜索。如果請求參數中同時出現UserName、AccessKeyId，查詢的結果需要同時滿足這兩個條件。 類型 ：字符串 取值 ：1~64個字符組成，字符只能包含字母、數字或特殊字符，字母不區分大小寫，特殊字符只能是：下劃線（_）、中劃線（-）、逗號（,）、句點（.）、加號（+）、等號（=）和at符號（@）。 |
否 |
| AccessKeyId | 按指定的AccessKeyId，進行模糊匹配搜索。 UserName、AccessKeyId共用時，查詢出同時滿足多個查詢條件的結果。 |
否 |
響應結果
名稱 描述 Users.member.UserName IAM用戶名。 Users.member.UserId IAM用戶ID。 Users.member.Arn IAM用戶的資源名稱。 Users.member. MFADeviceCount IAM用戶關聯的MFA數量。 Users.member.CreateDate 創建IAM用戶的時間，采用ISO 8601日期時間格式。 Users.member.PasswordLastUsed 上次使用用戶密碼登錄OOS網站的時間，采用ISO 8601日期時間格式。
說明
如果從未使用密碼登錄，不返回此字段。
如果用戶當前沒有密碼，但過去有密碼，則此字段包含最近使用密碼的時間。
Users.member.AccessKeyCount 用戶的AK數量。 Users.member.PasswordCreateDate 密碼的創建時間。
說明
如果更新過密碼，返回密碼的最近一次更新的時間。
若無密碼，則不返回此項。
IsTruncated 用戶是否已經都返回：
true：有未返回的用戶。
false：已經返回所有的用戶。
Marker 分頁標識。當IsTruncated是true時，該項存在，并且包含要用于后續分頁請求的參數Marker值。
請求示例
列出所有IAM用戶。
POST?/?HTTP/1.1
Host:oos-cn-iam.ctyunapi.cn
x-amz-content-sha256:?UNSIGNED-PAYLOAD
Authorization: SignatureValue
X-Amz-Date:?20190131T025354Z
Content-Type:?application/octet-stream
?
Action=ListUsers&Version=2010-05-08
響應示例
HTTP/1.1?200?OK
x-amz-request-id:826cfcba138c4af3
Content-Type:text/xml;charset=UTF-8
Content-Length:2215
Date:Thu,?31?Jan?2019?02:53:54?GMT
Server:?CTYUN
?
<ListUsersResponse>
????<ListUsersResult>
????????<IsTruncated>false</IsTruncated>
????????<Users>
???????????<member>
???????????????<PasswordLastUsed>2019-01-07T05:57:35Z</PasswordLastUsed>
???????????????<UserName>test_user</UserName>
???????????????<Arn>arn:ctyun:iam::10rc2arpn6306:user/test_user</Arn>
???????????????<UserId>ed3cf79eda454f04871a87386792914f</UserId>
???????????????<CreateDate>2019-01-07T05:53:20Z</CreateDate>
???????????????<?AccessKeyCount>1</AccessKeyCount>???????????????
???????????????<?MFADeviceCount>1</MFADeviceCount>
???????????????<PasswordCreaeDate>2019-01-07T05:53:20Z</PasswordCreaeDate>
???????????</member>
???????????<member>
???????????????<UserName>test_user_1</UserName>
???????????????<Arn>arn:ctyun:iam::10rc2arpn6306:user/test_user_1</Arn>
???????????????<UserId>dd3cf79eda454f04871a87386792914f</UserId>
???????????????<CreateDate>2019-01-31T01:40:20Z</CreateDate>
???????????????<AccessKeyCount>0</AccessKeyCount>
???????????????<MFADeviceCount>0</MFADeviceCount>
???????????</member>
????????</Users>
????</ListUsersResult>
????<ResponseMetadata>
????????<RequestId>826cfcba138c4af3</RequestId>
????</ResponseMetadata>
</ListUsersResponse>
