调用AddExistedNodes添加一个或多个已创建的ECS实例作为计算节点,加入到指定集群中。

接口说明

  • 待添加到集群的节点处于已停止状态。
  • 加入集群后,该节点的操作系统会更换为ImageId指定的操作系统。
  • 节点主机名不能和集群内已有节点的主机名冲突,否则会添加失败。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddExistedNodes

系统规定参数,取值:AddExistedNodes

ClusterId String ehpc-hz-FYUr32****

该节点待加入的集群ID。

您可以通过调用ListClusters获取集群ID。

ImageId String centos_7_06_64_20G_alibase_20190711.vhd

为待加入集群的计算节点指定的镜像,该镜像需满足以下条件:

  • 指定的镜像的操作系统应与集群中节点的操作系统保持一致。如:集群中节点的操作系统为CentOS时,只能指定CentOS镜像。
    说明 如果集群为混合云集群,并且开启支持多系统功能,当集群中节点的操作系统为Windows时,指定的镜像可以为Windows、CentOS。
  • 指定的镜像应与集群节点的镜像大版本号保持一致,如待加入集群为CentOS 7.x,指定的镜像也应该为CentOS 7.x。

您可以通过调用ListImagesListCustomImages接口获取镜像ID。

ImageOwnerAlias String system

镜像类型。取值范围:

  • system:公共镜像
  • self:自定义镜像
  • others:共享镜像
  • marketplace:镜像市场镜像

默认值:system

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

第N个(N从1开始编号,可以有多条)要添加的节点ID。取值范围:1~100。

JobQueue String workq

该节点要加入的集群中的队列。

返回数据

名称 类型 示例值 描述
RequestId String 04F0F334-1335-436C-A1D7-6C044FE7****

请求ID。

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

任务ID。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=AddExistedNodes
&ClusterId=ehpc-hz-FYUr32****
&ImageId=centos_7_06_64_20G_alibase_20190711.vhd
&ImageOwnerAlias=system
&Instance.1.Id=i-bp16mxn6mt3t7ftk****
&<公共请求参数>

正常返回示例

XML格式

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

JSON格式

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

错误码

HttpCode 错误码 错误信息 描述
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败,服务暂时不可用

访问错误中心查看更多错误码。