请求参数
名称 |
类型 |
必须 |
长度限制(字符) |
参数格式 |
描述 |
Action |
String |
是 |
确定值 |
[a-zA-Z]+ |
操作接口名,系统规定参数,取值:ListUsers |
PathPrefix |
String |
否 |
最短1,最长512 |
/ |
可选参数,用户名的路径,当前只能传入/ |
Marker |
String |
否 |
最短1,最长320 |
[:graph:]+ |
当返回结果被截断时,使用本次返回的Marker值用于标示下次调用查询用户操作的起始点 |
MaxItems |
Integer |
否 |
最小值1,最大值1000,默认100 |
|
用于限制本次查询结果返回的用户数量,如果仍有额外用户未显示,则返回元素中的IsTruncated的值会被设置为true,同时返回下次查询的起始点Marker值 |
返回元素(调用成功)
名称 |
类型 |
描述 |
IsTruncated |
Boolean |
截断标志位,用于说明是否仍有更多的用户未显示全 |
Marker |
String |
如果截断标志位是true,Marker值被设定,用于标识下次查询的起始点 |
Users |
UserType List |
用户基本信息列表 |
错误码(调用不成功)
错误代码(Code) |
错误消息(Message) |
HTTP 状态码 |
中文描述(语义) |
InvalidParameterValue |
An invalid or out-of-range value was supplied for the input parameter %s. |
400 |
输入参数 %s的值无效、不合法或者超出范围,具体参数名在%s说明 |
示例(调用成功)
请求示例
https://iam.api.ksyun.com/?Action=ListUsers&公共请求参数
返回示例
<ListUsersResponse>
<ListUserResult>
<Users>
<member>
<Id>1234</Id>
<Path>/</Path>
<UserName>Bob</UserName>
<RealName>测试</RealName>
<UserId>lX9TJiSfTtq-rAJ3SVtcow</UserId>
<Krn>krn:ksc:iam::73407420:user/Bob</Krn>
<CreateDate>2016-05-16T14:44:20.000Z</CreateDate>
<PasswordLastUsed/>
</member>
</Users>
<Marker>MTE0Y2Y1MWEtNmQxZC00YjU3LTk5NzgtZTkzMjA2NDRkNjE0XzE=</Marker>
<IsTruncated>true</IsTruncated>
</ListUserResult>
<ResponseMetadata>
<RequestId>114cf51a-6d1d-4b57-9978-e9320644d614</RequestId>
</ResponseMetadata>
</ListUsersResponse>
{
"ListUserResult": {
"Users": {
"member": [
{
"Id" : 1234,
"Path": "/",
"UserName": "Bob",
"RealName": "测试",
"UserId": "lX9TJiSfTtq-rAJ3SVtcow",
"Krn": "krn:ksc:iam::73407420:user/Bob",
"CreateDate": "2016-05-16T14:44:20.000Z"
}
]
},
"Marker": "YTllZDk1OGUtYTVkNS00NjU4LWE1NDItMjc4MWY2NTVkMGI3XzE=",
"IsTruncated": true
},
"ResponseMetadata": {
"RequestId": "a9ed958e-a5d5-4658-a542-2781f655d0b7"
}
}