调用ListUsers查询集群中的用户列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListUsers

系统规定参数。取值：ListUsers
ClusterId String 是 ehpc-hz-FYUr32****

集群ID。
PageNumber Integer 否 1

当前页码。

起始值：1

默认值：1
PageSize Integer 否 10

每页显示的条数。取值范围：1~50

默认值：10

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

当前页码。
PageSize Integer 1

本页条数。
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。
TotalCount Integer 1

列表条目总数。
Users Array of UserInfo

账户信息UserInfo组成的数组。
UserInfo
AddTime String 2018-07-18T17:46:47

添加用户的时间。
Group String wheel

用户组。可能值：

  • users：非root且无sudo权限的用户。
  • wheel：非root但可通过sudo执行命令的用户。
Name String user1

用户名。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=ListUsers
&ClusterId=ehpc-hz-FYUr32****
&<公共请求参数>

正常返回示例

XML格式 

<ListUsersResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <TotalCount>1</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>1</PageSize>
      <Users>
            <UserInfo>
                  <Name>user1</Name>
                  <Group>users</Group>
            </UserInfo>
            <UserInfo>
                  <Name>user2</Name>
                  <Group>wheel</Group>
            </UserInfo>
      </Users>
</ListUsersResponse>

JSON格式 

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 1,
    "Users": {
        "UserInfo": [
            {
                "Name": "user1",
                "Group": "users"
            },
            {
                "Name": "user2",
                "Group": "wheel"
            }
        ]
    }
}

错误码

HttpCode 错误码 错误信息 描述
406 AgentError.Account.DomainNotExist Specific domain not exists: %s 域服务不存在: {}，请您检查该参数是否正确。
406 AgentError.Account.GetentPasswdFailure Failed to get the user list: %s 获取域用户列表失败: {}
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

访问错误中心查看更多错误码。