Deletes one or more users from a cluster.

Description

If you delete a user, only its information is deleted. The files stored in the /home directory for the user are still retained. For example, if you delete a user named user1, the files in the /home/user1/ directory of the cluster are not deleted. However, a deleted user cannot be recovered. Even if you create another user that has the same name, the data that was retained for the deleted user is not reused.

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 DeleteUsers

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

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 Yes user1

The name of the user that you want to delete. Valid values of N: 1 to 100.

You can call the ListUsers operation to query the users of the cluster.

Response parameters

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

The ID of the request.

Examples

Sample requests

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=DeleteUsers
&ClusterId=ehpc-hz-FYUr32****
&User.1.Name=user1
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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 %s parameter is invalid.
500 UnknownError An unknown error occurred. The error message returned because an unknown error has occurred. Try again later.
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.
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.
406 AgentError The agent service request failed. The error message returned because the proxy request has failed.
406 AgentError.Account.DomainNotExist The specified domain does not exist: %s. The error message returned because the {} domain account service does not exist: {}.
406 AgentError.Account.GetentPasswdFailure Failed to get the user list: %s. The error message returned because the list of domain users failed to be obtained: {}.
406 AgentError.Account.UserNotExist The specified user is not found in the domain: %s. The error message returned because the %s user does not exist in the domain.
406 AgentError.Account.UserDeleteFailure Failed to delete user from domain: %s. The error message returned because the following users failed to be deleted from the domain: {}.
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.
409 PartFailure Part of the batch operation failed. The error message returned because the batch operation has failed.

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