CreateNodes - 批量创建计算节点

更新时间:
复制为 MD 格式

批量给E-HPC集群创建计算节点。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ehpc:CreateNodes

create

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

ClusterId

string

待查询的集群 ID。

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

ehpc-hz-FYUr32****

QueueName

string

计算节点所属的队列名称。

test1

Count

integer

添加的计算节点数量。取值范围:1~99,并且 MinCount<Count。

  • ECS 库存数量<MinCount,添加节点失败。

  • MinCount<ECS 库存数量<Count,按照 MinCount 指定的数量添加节点。

  • Count<ECS 库存数量,按照 Count 指定的数量添加节点。

10

MinCount

integer

10

ComputeNode NodeTemplate

计算节点的硬件配置。

HPCInterConnect

string

计算节点间的网络类型。可能值:

  • vpc

  • eRDMA

vpc

VSwitchId

string

交换机 ID。

vsw-bp1lfcjbfb099rrjn****

RamRole

string

队列中计算节点绑定的是授权实例角色名称。

AliyunServiceRoleForOOSBandwidthScheduler

HostnamePrefix

string

队列中计算节点主机名前缀。

compute

HostnameSuffix

string

队列中计算节点主机名后缀。

demo

KeepAlive

string

计算节点是否开启删除保护。

false

DeploymentSetId

string

部署集 ID。 您可以通过 DescribeDeploymentSets 获取部署集 ID,当前仅支持网络低时延策略的部署集。

ds-bp1frxuzdg87zh4pzq****

ReservedNodePoolId

string

预设节点池 ID。

rnp-756vlp7a

Hostnames

array

string

返回参数

名称

类型

描述

示例值

object

返回结果。

RequestId

string

请求 ID。

04F0F334-1335-436C-A1D7-6C044FE73368

Success

boolean

执行命令并获取结果的过程是否成功。取值范围:

  • true:成功。

  • false:失败。

true

InstanceIds

array

待创建的计算节点列表。

string

待创建的计算节点列表。

[ "i-uf68t1zu3jkhs8w****", "i-uf6abz34m2714bp****", "i-uf65bh2113hlqvyx****", "i-uf68t1zu3jkhs8wx****", "i-uf6b0mtpx166fxxi****", "i-uf6faknz4dy1bit7****" ]

示例

正常返回示例

JSON格式

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "Success": true,
  "InstanceIds": [
    "[ \"i-uf68t1zu3jkhs8w****\", \"i-uf6abz34m2714bp****\", \"i-uf65bh2113hlqvyx****\", \"i-uf68t1zu3jkhs8wx****\", \"i-uf6b0mtpx166fxxi****\", \"i-uf6faknz4dy1bit7****\" ]"
  ]
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParams The specified parameter %s is invalid. 指定的参数 %s 无效。
403 ConflictOpt A conflicting operation is running. 有冲突的操作在执行中,请您稍后再试。
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败,服务暂时不可用
406 DbError A database service error occurred. 数据库请求失败
406 EcsError An error occurred while calling the ECS API operation. ECS API调用出错. %s
406 InsufficientReservedNodes There is no more available reserved nodes. 预留节点数量不足

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

变更历史

更多信息,参考变更详情