Deletes one or more compute nodes from a cluster.

Description

Before you delete a compute node, we recommend that you export all job data from the node to prevent data loss.

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 DeleteNodes

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

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

The ID of the cluster.

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

ReleaseInstance Boolean No true

Specifies whether to release the instances that are created by using E-HPC.

Default value: true

Sync Boolean No false

Specifies whether to directly delete the node. Valid values:

  • true
  • false
Instance.N.Id String No i-bp13p7vlcb1uihfv****

The ID of the compute node that you want to delete. Valid values of N: 1 to 100.

You can call the DescribeCluster operation to query the IDs of the nodes in the cluster.

Response parameters

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

The ID of the task.

  • If you set the Sync parameter to true, the DeleteNodes operation is synchronous. Valid value: Not Available.
  • If you set the Sync parameter to false, the DeleteNodes operation is asynchronous. You can call the ListTasks operation to query the result of the task.
RequestId String 04F0F334-1335-436C-A1D7-6C044FE7****

The ID of the request.

Examples

Sample requests

http(s)://ehpc.cn-hangzhou.aliyuncs.com/?Action=DeleteNodes
&ClusterId=ehpc-hz-FYUr32****
&<Common request parameters>

Sample success responses

XML format

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

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

JSON format

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

{
  "DeleteNodesResponse" : {
    "TaskId" : "04F0F334-1335-436C-A1D7-6C044FE7****",
    "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 is not activated for your account.
500 UnknownError An unknown error occurred. The error message returned because an unknown error has occurred. Try again later. If the error persists, submit a ticket.
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.
403 InvalidNodeStatus The operation failed due to invalid node status. The error message returned because the operation is not supported while the nodes are in the current state.
403 ConflictOpt A conflicting operation is running. The error message returned because an operation that conflicts with the current operation is in progress. Try again later.
404 ClusterNotFound The specified cluster does not exist. The error message returned because the specified cluster does not exist.
404 ComputeNotFound The specified compute node does not exist. The error message returned because the specified compute node 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.
404 ObjectNotFound The specified object is not found. The error message returned because the specified object does 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.
406 EcsError An error occurred while calling the ECS API operation. The error message returned because the ECS API call has failed.
406 EipError The EIP API request failed. The error message returned because the operation has failed to call the EIP service.
406 DbError A database service error occurred. The error message returned because the database request has failed.
406 AliyunError An Alibaba Cloud product error occurred. The error message returned because the operation has failed to call another Alibaba Cloud service.
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.