Adds one or more users in a cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes AddUsers

The operation that you want to perform. Set the value to AddUsers.

ClusterId String Yes ehpc-hz-FYUr32****

The ID of the cluster.

You can call the ListClusters operation to query the cluster ID.

User.N.Name String No user1

The name of the user that you want to add. The username must be 6 to 30 characters in length and start with a letter. It can contain letters, digits, and periods (.).

Valid values of N: 1 to 100

User.N.Group String No users

The permission group to which the user belongs. Valid values:

  • users: an ordinary permission group. It is applicable to ordinary users that need only to submit and debug jobs.
  • wheel: a sudo permission group. It is applicable to the administrator who needs to manage the cluster. In addition to submitting and debugging jobs, users who have sudo permissions can run sudo commands to install software and restart nodes.

Valid values of N: 1 to 100

User.N.Password String No 1@a2****

The password of the user. It must be 8 to 30 characters in length and contain three of the following items:

  • Uppercase letter
  • Lowercase letter
  • Digit
  • Special character: ()~!@#$%^&*-_+=|{}[]:;'/<>,.?/

Valid values of N: 1 to 100

Note We recommend that you use HTTPS to call the AddUsers operation to ensure that the password remains confidential.

Response parameters

Parameter Type Example Description
RequestId String 04F0F334-1335-436C-A1D7-6C044FE7****

The ID of the request.

Examples

Sample requests

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****
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

HttpCode Error code Error message Description
400 InvalidParams The specified parameter %s is invalid. The error message returned because the following parameter is invalid: %s.
400 NotEnabled You have not enabled this service The error message returned because the service has not been activated for your account.
400 InDebt Your account has overdue payments. The error message returned because your account has overdue payments.
403 InvalidClusterStatus The operation failed due to invalid cluster status. The error message returned because the operation is not supported while the cluster is in the current state.
404 ClusterNotFound The specified cluster does not exist. The error message returned because the specified cluster does not exist.
404 ManagerNotFound The manager nodes do not exist or their status is abnormal. The error message returned because the management node does not exist or is not running as expected.
407 NotAuthorized You are not authorized by RAM for this request. The error message returned because you are not authorized by RAM for this request.
406 AgentError The agent service request failed. The error message returned because the proxy request has failed.
406 AgentError.Account.GetentPasswdFailure Failed to get the user list: %s. The error message returned because the list of domain users {} has failed to be obtained.
406 AgentError.Account.UserAlreadyExist The specified user already exists in domain: %s. The error message returned because the following users already exist in the domain: {}.
406 AgentError.Account.UserAddFailure Failed to add user to domain: %s. The error message returned because the following users have failed to be added to the domain: {}.
409 PartFailure Part of the batch operation failed. The error message returned because the batch operation has failed.
500 UnknownError An unknown error occurred. The error message returned because an unknown error has occurred.
406 AgentError.Account.DomainNotExist The specified domain does not exist: %s. The error message returned because the following domains do not exist: {}.
503 ServiceUnavailable The request has failed due to a temporary failure of the server The error message returned because the request has failed. The service is temporarily unavailable.

For a list of error codes, visit the API Error Center.