更新时间:2025-07-25 GMT+08:00
分享

批量创建实例

功能介绍

批量创建实例,其中调度策略支持:

1、指定服务器

2、基于空闲随机调度策略

支持VPC网络及AI参数面网络配置。

此接口为异步接口,实例的创建和启动不是立即完成的,通过接口 ShowInstanceStatus 查询实例状态为 running 代表实例创建成功。

接口约束:服务器manage_stateready

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/instances/batch-create

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID

约束限制

不涉及

取值范围

账号的项目ID

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

调用接口的认证方式分为Token,如果您使用的Token方式,此参数为必填,请填写Token的值

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

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

默认取值

不涉及

表4 network_interfaces

参数

是否必选

参数类型

描述

subnet_id

String

参数解释

subnet ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表5 metadata

参数

是否必选

参数类型

描述

{自定义key}

Map<String,String>

参数解释

创建裸机实例的元数据。可以通过元数据自定义键值对。

如果元数据中包含了敏感数据,您应当采取适当的措施来保护敏感数据,比如限制访问范围、加密等。

约束限制

不涉及

取值范围

最多可注入10对键值(Key/Value)。

主键(Key)只能由大写字母(A-Z)、小写字母(a-z)、数字(0-9)、中划线(-)、下划线(_)、冒号(:)、空格( )和小数点(.)组成,长度为[1-255]个字符。

值(value)最大长度为255个字符。

默认取值

不涉及

表6 placement

参数

是否必选

参数类型

描述

server_id_set

Array of strings

参数解释

指定服务器id集合

约束限制

服务器id不超过50条

响应参数

状态码:202

表7 响应Body参数

参数

参数类型

描述

instances

Array of instances objects

参数解释

实例返回信息

约束限制

不涉及

表8 instances

参数

参数类型

描述

id

String

参数解释

实例ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

状态码:400

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

状态码:401

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

状态码:429

表11 响应Body参数

参数

参数类型

描述

-

String

-

状态码:500

表12 响应Body参数

参数

参数类型

描述

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

服务端内部错误

错误码

请参见错误码

相关文档