调用AddUsers为指定集群新增一个或多个用户。

调试

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

请求参数

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

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

集群ID。

您可以通过调用ListClusters获取集群ID。

User.N.Name String 否 user1

第N个新增的用户名。长度为6~30个字符，必须以英文字母开头，可以包含数字、特殊字符（.）。

N的取值范围：1~100
User.N.Group String 否 users

第N个新增用户的用户组。取值范围：

  • users：普通权限组，适用于只有提交、调试作业需求的普通用户。
  • wheel：sudo权限组，适用于需要管理集群的管理员，除提交、调试作业外，还可以执行sudo命令进行安装软件、重启节点等操作。

N的取值范围：1~100
User.N.Password String 否 1@a2****

第N个新增用户的密码。长度为8~30个字符，必须同时包含一下四项中的三项：

  • 大写英文字母
  • 小写英文字母
  • 数字
  • 特殊字符：()~!@#$%^&*-_+=|{}[]:;'/<>,.?/

N的取值范围：1~100

说明 建议使用HTTPS协议调用API以避免可能发生的密码泄露。

返回数据

名称 类型 示例值 描述
RequestId String 04F0F334-1335-436C-A1D7-6C044FE7****

请求ID。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=AddUsers
&ClusterId=ehpc-hz-FYUr32****
&User.1.Name=user1
&User.1.Group=users
&User.1.Password=1@a2****
&<公共请求参数>

正常返回示例

XML格式 

<AddUsersResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE7****</RequestId>
</AddUsersResponse>

JSON格式 

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE7****"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The specified parameter %s is invalid. 无效的参数: %s
400 NotEnabled You have not enabled this service 您的账户还未开通此服务
400 InDebt Your account has overdue payments. 您的账户已欠费
403 InvalidClusterStatus The operation failed due to invalid cluster status. 集群状态不允许执行本次操作。
404 ClusterNotFound The specified cluster does not exist. 指定的集群不存在，请您检查该参数是否正确。
404 ManagerNotFound The manager nodes do not exist or their status is abnormal. 管理节点不存在或状态异常。
407 NotAuthorized You are not authorized by RAM for this request. 此请求未获得RAM授权
406 AgentError The agent service request failed. 代理请求失败
406 AgentError.Account.GetentPasswdFailure Failed to get the user list: %s. 获取域用户列表失败: {}
406 AgentError.Account.UserAlreadyExist The specified user already exists in domain: %s. 用户在域中已存在: {}
406 AgentError.Account.UserAddFailure Failed to add user to domain: %s. 添加用户到域失败: {}
409 PartFailure Part of the batch operation failed. 批量操作部分失败
500 UnknownError An unknown error occurred. 未知错误
406 AgentError.Account.DomainNotExist The specified domain does not exist: %s. 域服务不存在: {}，请您检查该参数是否正确。
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

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