批量创建节点-BatchCreateNodes

aics:node:create

Write

node *

-

-

• ecs:cloudServers:listServersDetails
• ecs:cloudServerQuotas:get
• kps:SSHKeyPair:get
• evs:types:get
• evs:quotas:get
• vpc:subnets:get
• vpc:securityGroups:list
• ecs:cloudServers:createServers
• ecs:cloudServers:showServer
• ecs:cloudServers:updateMetadata
• evs:volumes:create
• evs:volumes:get

-

• g:RequestTag/<tag-key>

• g:TagKeys

project_id

是

String

参数解释:

项目ID，获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Auth-Token

否

String

参数解释:

用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Client-Token

否

String

参数解释:

保证请求幂等性的标识，携带相同标识的重复请求返回相同结果。

约束限制:

有效期8小时。

取值范围:

UUID格式，[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

默认取值:

不涉及。

count

是

Integer

参数解释:

创建节点的数量。

约束限制:

单次最多创建50个。

取值范围:

1-50。

默认取值:

不涉及。

min_count

否

Integer

参数解释:

要求最少成功的节点数量。当成功数量少于该值时，HPS会回退所有已创建的资源。

约束限制:

不能超过count的值。

取值范围:

1-count。

默认取值:

1。

node_type

是

String

参数解释:

节点规格。

约束限制:

需要该规格保证可售卖。

取值范围:

长度1-64，只能由英文字母、数字及"_"、"-"、"."组成。可通过查询节点规格列表获取。

默认取值:

不涉及。

image_id

是

String

参数解释:

节点镜像ID。

约束限制:

不涉及。

取值范围:

UUID格式，可通过镜像服务控制台获取。

默认取值:

不涉及。

keypair_name

否

String

参数解释:

节点登录密钥对名称。

约束限制:

与admin_password二选一。

取值范围:

长度1-64，只能由英文字母、数字及"_"、"-"、"."组成。可通过密钥对管理控制台获取。

默认取值:

不涉及。

admin_password

否

String

参数解释:

节点登录密码。

约束限制:

与keypair_name二选一，且admin_password存在时，不能设置user_data。

密码复杂度要求：8-26位，至少包含大写字母、小写字母、数字和特殊字符中的三种。

不能包含用户名或倒序的用户名（root）。

取值范围:

长度为8-26。

默认取值:

不涉及。

name

是

String

参数解释:

节点名称。批量创建时系统自动添加序号后缀。

约束限制:

同一租户下名称不可重复。

取值范围:

长度1-58（预留6字符给批量序号后缀），只能由英文字母、数字及"_"、"-"、"."组成。

默认取值:

不涉及。

cluster_id

是

String

参数解释:

集群唯一标识UUID。创建的节点将归属于该集群。

约束限制:

不涉及。

取值范围:

UUID格式。可通过查询集群列表接口获取。

默认取值:

不涉及。

network_interfaces

是

Array of NodeNetworkInterfaceOption objects

参数解释:

子网网卡信息，主网卡为数组索引为0的子网。

约束限制:

创建时网卡数量上限为3个。所有网卡需归属同一个VPC。

取值范围:

网卡数量为1-3。

默认取值:

不涉及。

root_volume

是

NodeRootVolume object

参数解释:

系统盘信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

data_volume

否

Array of NodeDataVolume objects

参数解释:

数据盘信息。

约束限制:

创建时数据盘数量上限为8个。

取值范围:

数据盘数量为0-8。

默认取值:

不涉及。

market_options

是

NodeMarketOptions object

参数解释:

计费信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

user_data

否

String

参数解释:

节点初始化配置数据。注入的数据为需要base64编码后的内容。

约束限制:

必须base64转码，转码后长度不大于40k。

取值范围:

长度为0-40960。

默认取值:

不涉及。

tags

否

Array of TagKv objects

参数解释:

租户标签。

约束限制:

不涉及。

取值范围:

标签数量为0-20。

默认取值:

不涉及。

metadata

否

Array of Metadata objects

参数解释:

节点元数据。

约束限制:

不允许传入重复key、黑名单中的key或以_sys_开头的key。

取值范围:

元数据数量为0-5。

默认取值:

不涉及。

ipv6_enable

否

Boolean

参数解释:

是否开启IPv6。

约束限制:

不涉及。

取值范围:

• true: 开启IPv6。

• false: 不开启IPv6。

默认取值:

false。

security_groups

否

Array of strings

参数解释:

安全组ID列表。

约束限制:

不涉及。

取值范围:

安全组数量为0-20。可通过VPC安全组控制台获取。

默认取值:

不涉及。

subnet_id

是

String

参数解释:

子网ID。

约束限制:

所有的subnet_id需要归属同一个VPC。

取值范围:

UUID格式。可通过VPC子网控制台获取。

默认取值:

不涉及。

uboe_enable

否

Boolean

参数解释:

是否使能UBoE。如果为true，节点将创建并挂载UBoE高速port。

约束限制:

第一个interface（主网卡）无法使能UBoE。

取值范围:

• true: 使能UBoE。

• false: 不使能UBoE。

默认取值:

false。

size

是

Integer

参数解释:

系统盘大小，单位GiB。

约束限制:

不涉及。

取值范围:

1-1024。

默认取值:

不涉及。

type

是

String

参数解释:

系统盘类型。

约束限制:

支持的磁盘类型列表。

取值范围:

SSD、ESSD、GPSSD、SAS、SATA等。

默认取值:

不涉及。

size

是

Integer

参数解释:

数据盘大小，单位GiB。

约束限制:

不涉及。

取值范围:

10-32768。

默认取值:

不涉及。

type

是

String

参数解释:

数据盘类型。

约束限制:

支持的磁盘类型列表。

取值范围:

SSD、ESSD、GPSSD、SAS、SATA等。

默认取值:

不涉及。

count

否

Integer

参数解释:

数据盘数量。

约束限制:

不涉及。

取值范围:

1-8。

默认取值:

1。

charging_mode

是

String

参数解释:

付费类型。

约束限制:

不涉及。

取值范围:

• prePaid: 包周期付费。

• postPaid: 按需付费（正式购买，经 CBC ondemand 下单后立即创建）。

默认取值:

prePaid。

is_auto_pay

否

Boolean

参数解释:

是否自动支付。

约束限制:

不涉及。

取值范围:

• true: 自动支付。

• false: 不自动支付。

默认取值:

false。

is_auto_renew

否

Boolean

参数解释:

是否自动续费。

约束限制:

不涉及。

取值范围:

• true: 自动续费。

• false: 不自动续费。

默认取值:

false。

period_num

否

Integer

参数解释:

订购周期数量。

约束限制:

按订购周期类型限制： - 包月（period_type=MONTH）：1~9 - 包年（period_type=YEAR）：1~5

取值范围:

包月：1~9；包年：1~5。

默认取值:

不涉及。

period_type

否

String

参数解释:

订购周期类型。

约束限制:

不涉及。

取值范围:

• MONTH: 月。

• YEAR: 年。

默认取值:

不涉及。

cloudservice_console_url

否

String

参数解释:

CBC传递的云服务控制台URL地址。

约束限制:

仅CBC付费完成后，需要跳转对应console界面场景使用。

取值范围:

长度为1-1024。

默认取值:

不涉及。

promotion_info

否

String

参数解释:

折扣信息。

约束限制:

不涉及。

取值范围:

长度为1-64。

默认取值:

不涉及。

key

是

String

参数解释:

标签键。

约束限制:

不能以_sys_开头；首尾不能为空白字符。

取值范围:

最大128个Unicode字符。只能由大小写字母、数字、中文、空格及"_"、"-"、"."、":"、"/"、"="、"+"、"@"组成。

默认取值:

不涉及。

value

否

String

参数解释:

标签值。

约束限制:

创建/更新标签时必填，可为空字符串（""），但不能为 null 或缺省；

删除标签时可不传（删除只需 key）。

取值范围:

最大255个Unicode字符。只能由大小写字母、数字、中文、空格及"_"、"-"、"."、":"、"/"、"="、"+"、"@"、"&"组成。

默认取值:

不涉及。

key

是

String

参数解释:

元数据键。

约束限制:

不允许传入黑名单中的key或以_sys_开头的key。

取值范围:

长度1-200，只能由英文字母、数字及"_"、"-"、"."、":"组成。

默认取值:

不涉及。

value

是

String

参数解释:

元数据值。

约束限制:

不涉及。

取值范围:

长度0-200。

默认取值:

不涉及。

order_id

String

参数解释:

订单ID。包周期（prePaid）创建时返回CBC订单号；按需（postPaid）无CBC订单号，不返回该字段。

取值范围:

不涉及。

batch_id

String

参数解释:

批次ID。

取值范围:

UUID格式。

202

成功提交创建节点任务。