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


  • 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.


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 AddExistedNodes

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

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

The ID of the cluster.

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

ImageId String Yes centos_7_06_64_20G_alibase_20190711.vhd

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 by 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 is 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.

ImageOwnerAlias String Yes system

The type of the image. Valid values:

  • system: public image
  • self: custom image
  • others: shared image
  • marketplace: Alibaba Cloud Marketplace image

Default value: system

Instance.N.Id String Yes i-bp16mxn6mt3t7ftk****

The Nth node ID. N starts from 1. Valid values: 1 to 100.

JobQueue String No workq

The queue in the cluster to which the node is to be added.

Response parameters

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

The ID of the request.

TaskId String 04F0F334-1335-436C-A1D7-6C044FE7****

The ID of the task.


Sample requests
&<Common request parameters>

Sample success responses

XML format


JSON format

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

Error codes

HttpCode Error code Error message Description
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.