查询子用户列表

最近更新时间:2018-12-20 17:27:37

查询用户列表(ListUsers)

描述

查询IAM用户列表

返回API概览

请求参数

名称 类型 必须 长度限制(字符) 参数格式 描述
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&公共请求参数
返回示例
  • XML格式
<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>
  • JSON示例
{
    "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"
    }
}

金山云,开启您的云计算之旅

注册有礼