批量创建实例
功能介绍
批量创建实例,其中调度策略支持:
1、指定服务器
2、基于空闲随机调度策略
支持VPC网络及AI参数面网络配置。
此接口为异步接口,实例的创建和启动不是立即完成的,通过接口 ShowInstanceStatus 查询实例状态为 running 代表实例创建成功。
接口约束:服务器manage_state为 ready
调用方法
请参见如何调用API。
URI
POST /v1/{project_id}/instances/batch-create
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID 约束限制: 不涉及 取值范围: 账号的项目ID 默认取值: 不涉及 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 调用接口的认证方式分为Token,如果您使用的Token方式,此参数为必填,请填写Token的值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
参数解释: 设置实例主机名称。 约束限制: 不涉及 取值范围: 只能由中文字符、英文字母(a~z,A~Z)、数字(0~9)、下划线(_)、中划线(-)、点(.)组成,且长度为[1-63]个字符 默认取值: 不涉及 |
image_id |
是 |
String |
参数解释: 镜像ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
vpc_id |
是 |
String |
参数解释: 创建网卡所属的 VPC ID,可通过 VPC API 查询:https://support.huaweicloud.com/api-vpc/vpc_api01_0003.html。 约束限制: 不涉及 取值范围: VPC ID 默认取值: 不涉及 |
network_interfaces |
是 |
Array of network_interfaces objects |
参数解释: 指定裸金属服务器的网卡信息。 约束限制: 一个裸金属服务器最多挂载2个网卡,参数中第一个网卡会作为裸金属服务器的主网卡。若用户指定了多组网卡参数,需保证各组参数都属于同一VPC。 |
password |
是 |
String |
参数解释: 设置实例的管理员账户初始登录密码,其中,Linux管理员账户为root,Windows管理员账户为Administrator。 约束限制: 不涉及 取值范围: 长度为8-26位。 密码至少必须包含大写字母、小写字母、数字和特殊字符(!@$%^-_=+[{}]:,./?)中的三种。 密码不能包含用户名或用户名的逆序。 默认取值: 不涉及 |
metadata |
否 |
表5 object |
- |
description |
否 |
String |
参数解释: 裸机实例的描述信息。 约束限制: 不涉及 取值范围: 最大255字符长度 默认取值: 默认为空字符串 |
placement |
否 |
placement object |
参数解释: 实例placement,指定服务器策略。不指定placement,按min_count、max_count从空闲服务器中选择。 约束限制: 不涉及 |
min_count |
否 |
Integer |
参数解释: 必须成功启动的最小实例数量。如果无法满足此数量,整个请求失败(不会启动任何实例)。 约束限制: 不指定placement,该参数才生效 不大于max_count 取值范围: 1-100 默认取值: 不涉及 |
max_count |
否 |
Integer |
参数解释: 允许启动的最大实例数量。尝试启动最多该数量的实例,但实际启动数可能介于 min_count 和 max_count 之间 约束限制: 不指定placement,该参数才生效 不小于min_count 取值范围: 1-100 默认取值: 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
subnet_id |
是 |
String |
参数解释: subnet ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:202
参数 |
参数类型 |
描述 |
---|---|---|
instances |
Array of instances objects |
参数解释: 实例返回信息 约束限制: 不涉及 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
error_msg |
String |
参数解释: 错误描述 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
error_msg |
String |
参数解释: 错误描述 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码:429
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
- |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
error_msg |
String |
参数解释: 错误描述 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求示例
批量创建实例
POST https://{endpoint}/v1/{project_id}/instances/batch-create
响应示例
状态码:202
RunInstances应答
{ "instances" : { "id" : "0198170e-4ca7-7ee4-89a7-fa631843920b" } }
状态码
状态码 |
描述 |
---|---|
202 |
RunInstances应答 |
400 |
请求参数错误,请求失败 |
401 |
请求未鉴权 |
429 |
请求过载 |
500 |
服务端内部错误 |
错误码
请参见错误码。