AddExistedNodes - Elastic High Performance Computing - Alibaba Cloud Documentation Center

Adds one or more existing ECS instances as compute nodes to a specified cluster.

Operation description

The compute nodes to be added are in the Stopped state.
After the compute nodes are added to the cluster, the operating systems of the nodes are replaced with the operating system specified by the ImageId parameter.
The hosts of the compute nodes must be different from those of the existing compute nodes in the cluster. Otherwise, the add operation fails.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	The ID of the cluster. You can call the ListClusters operation to query the cluster ID.	ehpc-hz-FYUr32****
ImageId	string	Yes	The ID of the image that is specified for the compute nodes. The image must meet the following requirements: The operating system that is specified for the image must be the same as that of the existing cluster nodes. For example, if the operating system of the cluster nodes is CentOS, you can select only a CentOS image. Note If you add nodes to a hybrid cloud cluster that supports multiple operating systems, you can select a Windows Server image or a CentOS image when the operating system of the cluster nodes is Windows. The major version of the image specified for the compute nodes that you want to add must be the same as that of the image of the cluster. For example, if the version of the cluster image is CentOS 7.x, the version of the image specified for the compute nodes must be CentOS 7.x. You can call the ListImages and ListCustomImages operations to query the image ID.	centos_7_06_64_20G_alibase_20190711.vhd
JobQueue	string	No	The queue in the cluster to which the node is to be added.	workq
ImageOwnerAlias	string	Yes	The type of the images. Valid values: system: public image. self: custom image others: shared image marketplace: Alibaba Cloud Marketplace image Default value: system.	system
Instance	object []	Yes	The information about the node that you want to add.
Id	string	Yes	The Nth node ID. N starts from 1. Valid values: 1 to 100.	i-bp16mxn6mt3t7ftk****

Response parameters

Parameter	Type	Description	Example
	object
TaskId	string	The task ID.	04F0F334-1335-436C-A1D7-6C044FE7****
RequestId	string	The request ID.	04F0F334-1335-436C-A1D7-6C044FE7****

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParams	The specified parameter %s is invalid.	The specified parameter %s is invalid.
400	NotEnabled	You have not enabled this service	You have not enabled this service
400	InDebt	Your account has overdue payments.	Your account has overdue payments.
403	TooManyComputes	The number of computing nodes exceeds the quota.	The number of computing nodes exceeds the quota.
403	InvalidClusterStatus	The operation failed due to invalid cluster status.	The cluster status does not support the operation.
403	InvalidOpt	The specified operation is invalid. Please try again later. If the problem still exists, submit a ticket.	-
403	ConflictOpt	A conflicting operation is running.	A conflicting operation is running. Please try again later.
403	ImageNotSupported	The specified image is not supported.	The specified image does not exist. Change the image and try again.
404	ImageNotFound	The specified image does not exist.	The specified image does not exist. Please verify the parameter.
404	ClusterNotFound	The specified cluster does not exist.	The specified instance does not exist.
404	VolumeNotFound	The specified volume does not exist.	The specified storage does not exist. Please verify the parameter.
404	ManagerNotFound	The manager nodes do not exist or their status is abnormal.	The manager nodes do not exist or their status is abnormal.
404	ObjectNotFound	The specified object is not found.	The specified object does not exist. Please verify the parameter.
406	EcsError	An error occurred while calling the ECS API operation.	An error occurred while calling the ECS API operation.
406	DbError	A database service error occurred.	Database request failed.
406	AliyunError	An Alibaba Cloud product error occurred.	An Alibaba Cloud product error occurred.
407	NotAuthorized	You are not authorized by RAM for this request.	The request is not authorized by RAM.
409	PartFailure	Part of the batch operation failed.	Part of the batch operation failed.
500	UnknownError	An unknown error occurred.	An unknown error occurred.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server	The request has failed due to a temporary failure of the server.

For a list of error codes, visit the Service error codes.