ListUsers
更新时间 2026-05-25 17:48:02
最近更新时间: 2026-05-25 17:48:02
本节主要介绍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值。
请求示例
列出所有名字中包含t的IAM用户。
POST / HTTP/1.1
Authorization: signatureValue
x-amz-date: 20260515T071510Z
x-amz-content-sha256: UNSIGNED-PAYLOAD
Content-Type: application/octet-stream
Content-Length: 86
Host: oos-cn-iam.ctyunapi.cn
Action=ListUsers&Version=2010-05-08&Marker=32fefj64y54gc|test-aa&MaxItems=2&UserName=t
响应示例
HTTP/1.1 200 OK
x-amz-request-id: d750440f970c4048
Content-Type: text/xml;charset=UTF-8
Content-Length: 868
Date: Thu, Fri, 15 May 2026 07:15:10 GMT
Server: CTYUN
<ListUsersResponse>
<ListUsersResult>
<Users>
<member>
<UserId>119ccd93785d4ae28d5cf179548b83f2</UserId>
<Arn>arn:ctyun:iam::32fefj64y54gc:user/test11</Arn>
<UserName>test11</UserName>
<PasswordCreateDate>2026-05-15T07:12:05Z</PasswordCreateDate>
<PasswordLastUsed>2026-05-15T07:14:52Z</PasswordLastUsed>
<AccessKeyCount>1</AccessKeyCount>
<MFADeviceCount>1</MFADeviceCount>
<CreateDate>2026-05-08T08:10:44Z</CreateDate>
</member>
<member>
<UserId>f51a8d8523b744ebb9088d1a0b220155</UserId>
<Arn>arn:ctyun:iam::32fefj64y54gc:user/test111</Arn>
<UserName>test111</UserName>
<AccessKeyCount>1</AccessKeyCount>
<MFADeviceCount>0</MFADeviceCount>
<CreateDate>2020-06-03T02:57:55Z</CreateDate>
</member>
</Users>
<IsTruncated>true</IsTruncated>
<Marker>32fefj64y54gc|test111</Marker>
</ListUsersResult>
<ResponseMetadata>
<RequestId>d750440f970c4048</RequestId>
</ResponseMetadata>
</ListUsersResponse>