文档简介:
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日期时间格式。 说明: l 如果从未使用密码登录,不返回此字段。 l 如果用户当前没有密码,但过去有密码,则此字段包含最近使用密码的时间。 |
Users.member.AccessKeyCount |
用户的AK数量 |
Users.member.PasswordCreateDate |
密码的创建时间。 说明: l 如果更新过密码,返回密码的最近一次更新的时间。 l 若无密码,则不返回此项。 |
IsTruncated |
用户是否已经都返回: l true:有未返回的用户; l false:已经返回所有的用户。 |
Marker |
分页标识。当IsTruncated是true时,该项存在,并且包含要用于后续分页请求的参数Marker值。 |
-
请求示例
列出所有IAM用户。
POST / HTTP/1.1 Host:oos-cn-iam.ctyunapi.cn Authorization:signatureValue X-Amz-Date:date 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> |