project_id

是

项目ID。

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

server

是

Object

弹性云服务器信息，请参见表3。

dry_run

否

Boolean

是否只预检此次请求，默认为false。

true：发送检查请求，不会创建实例。检查项包括是否填写了必需参数、请求格式等。

如果检查不通过，则返回对应错误。
如果检查通过，则返回202状态码。

false：发送正常请求，通过检查后并且执行创建云服务器请求。

imageRef

是

String

待创建云服务器的系统镜像，需要指定已创建镜像的ID，ID格式为通用唯一识别码（Universally Unique Identifier，简称UUID）。

镜像的ID可以从控制台或者参考《镜像服务API参考》的“查询镜像列表”的章节获取。

flavorRef

是

String

待创建云服务器的系统规格的ID。

已上线的规格请参见《弹性云服务器产品介绍》的“实例类型与规格”章节。

name

是

String

云服务器名称。

创建的云服务器数量（count字段对应的值）等于1时，云服务器名称只能由中文字符、英文字母、数字及“_”、“-”组成，且长度为[1-64]个字符。

创建的云服务器数量（count字段对应的值）大于1时，可以使用“自动排序”和“正则排序”设置有序的云服务器名称。

请参考创建多台云服务器云主机时怎样设置有序的云服务器云主机名称？

取值范围：

只能由中文字符、英文字母、数字及“_”、“-”组成，且长度为[1-64]个字符。
创建的云服务器数量（count字段对应的值）大于1时，为区分不同云服务器，创建过程中系统会自动在名称后加“-0000”的类似标记。若用户在名称后已指定“-0000”的类似标记，系统将从该标记后继续顺序递增编号。故此时名称的长度为[1-59]个字符。

说明：

云服务器虚拟机内部(hostname)命名规则遵循 RFC 952和RFC 1123命名规范，建议使用a-z或0-9以及中划线”-“组成的名称命名，”_”将在弹性云服务器内部默认转化为”-“。

user_data

否

String

创建云服务器过程中待注入实例自定义数据。支持注入文本、文本文件。

说明：

user_data的值为base64编码之后的内容。
注入内容（编码之前的内容）最大长度为32K。

更多关于待注入实例自定义数据的信息，请参见《弹性云服务器用户指南 》的“用户数据注入”章节。

示例：

base64编码前：

Linux服务器：

#!/bin/bash
echo user_test > /home/user.txt

Windows服务器：

rem cmd
echo 111 > c:\aaa.txt

base64编码后：

Linux服务器：

IyEvYmluL2Jhc2gKZWNobyB1c2VyX3Rlc3QgPiAvaG9tZS91c2VyLnR4dA==

Windows服务器：

cmVtIGNtZAplY2hvIDExMSA+IGM6XGFhYS50eHQ=

adminPass

否

String

如果需要使用密码方式登录云服务器，可使用adminPass字段指定云服务器管理员帐户初始登录密码。其中，Linux管理员帐户为root，Windows管理员帐户为Administrator。

密码复杂度要求：

长度为8-26位。
密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?~#*）中的三种。
密码不能包含用户名或用户名的逆序。
Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。

key_name

否

String

如果需要使用SSH密钥方式登录云服务器，请指定已创建密钥的名称。

密钥可以通过密钥创建接口进行创建（请参见 创建和导入SSH密钥），或使用SSH密钥查询接口查询已有的密钥（请参见查询SSH密钥列表 ）。

vpcid

是

String

待创建云服务器所属虚拟私有云（简称VPC），需要指定已创建VPC的ID，UUID格式。

VPC的ID可以从控制台或者参考《虚拟私有云接口参考》的“查询VPC”章节获取。

nics

是

Array of objects

待创建云服务器的网卡信息。详情请参见表4。

约束：

主网卡对应的网络（network）必须属于vpcid对应的VPC。用户创建网卡时，指定的第一张网卡信息为主网卡。
需要指定vpcid对应VPC下已创建的子网（subnet）的网络ID，UUID格式。

当前单个云服务器支持最多挂载12张网卡。
不同的规格对网卡上限有一定的区别，参考 规格清单。

publicip

否

Object

配置云服务器的弹性公网IP信息，弹性公网IP有三种配置方式。

不使用（无该字段）
自动分配，需要指定新创建弹性公网IP的信息
使用已有，需要指定已创建弹性公网IP的信息

详情请参见表1。

count

否

Integer

创建云服务器数量。

约束：

不传该字段时默认取值为1。
租户的配额足够时，最大值为500。

isAutoRename

否

Boolean

批量创建时是否使用相同的名称。默认为False，当count大于1的时候该参数生效。

True，表示使用相同名称。
False，表示自动增加后缀。

root_volume

是

Object

云服务器对应系统盘相关配置。

详情请参见表6。

data_volumes

否

Array of objects

云服务器对应数据盘相关配置。每一个数据结构代表一块待创建的数据盘。

约束：目前云服务器最多可挂载59块数据盘(部分规格只支持23块数据盘）

详情请参见表7。

security_groups

否

Array of objects

云服务器对应安全组信息。

约束：当该值指定为空时，默认给云服务器绑定default安全组。

详情请参见表2。

availability_zone

否

String

待创建云服务器所在的可用区，需要指定可用分区名称。

说明：

如果为空，会自动指定一个符合要求的可用区。

可通过接口 查询可用区列表 获取，也可参考地区和终端节点获取。

batch_create_in_multi_az

否

Boolean

是否支持随机多AZ部署，默认为false。

true：批量创建的ecs部署在多个AZ上
false：批量创建的ecs部署在单个AZ上

当availability_zone为空时该字段生效。

extendparam

否

Object

创建云服务器附加信息。

详情请参见表8。

metadata

否

Map

创建云服务器元数据。

可以通过元数据自定义键值对。

说明：

如果元数据中包含了敏感数据，您应当采取适当的措施来保护敏感数据，比如限制访问范围、加密等。
最多可注入10对键值（Key/Value）。
主键（Key）只能由大写字母（A-Z）、小写字母（a-z）、数字（0-9）、中划线（-）、下划线（_）、冒号（:）、空格（ ）和小数点（.）组成，长度为[1-255]个字符。
值（value）最大长度为255个字符。

系统预留键值对请参见表11。

os:scheduler_hints

否

Object

云服务器调度信息，例如设置云服务器组。

详情请参见表12。

tags

否

Array of strings

弹性云服务器的标签。

标签的格式为“key.value”。其中，key的长度不超过36个字符，value的长度不超过43个字符。

标签命名时，需满足如下要求：

标签的key值只能包含大写字母（A~Z）、小写字母（a~z）、数字（0-9）、下划线（_）、中划线（-）以及中文字符。
标签的value值只能包含大写字母（A~Z）、小写字母（a~z）、数字（0-9）、下划线（_）、中划线（-）、小数点（.）以及中文字符。

说明：

创建弹性云服务器时，一台弹性云服务器最多可以添加10个标签。
公有云新增server_tags字段，该字段与tags字段功能相同，支持的key、value取值范围更广，建议使用server_tags字段。

server_tags

否

Array of objects

弹性云服务器的标签。详情请参见表14。

说明：

创建弹性云服务器时，一台弹性云服务器最多可以添加10个标签。
公有云新增server_tags字段，该字段与tags字段功能相同，支持的key、value取值范围更广，建议使用server_tags字段。

description

否

String

云服务器描述信息，默认为空字符串。

长度最多允许85个字符。
不能包含“”。

auto_terminate_time

否

String

定时删除时间。

按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。

如果秒（ss）取值不是 00，则自动取为当前分钟（mm）开始时。

最短定时删除时间为当前时间半小时之后。

最长定时删除时间不能超过当前时间三年。

示例：2020-09-25T12:05:00Z

说明：

仅按需实例支持设置定时删除时间。

该字段当前仅在华北-北京四、华南-广州区域生效。

subnet_id

是

String

待创建云服务器所在的子网信息。

需要指定vpcid对应VPC下已创建的子网（subnet）的网络ID，UUID格式。

可以通过VPC服务查询子网列表接口查询。

ip_address

否

String

待创建云服务器网卡的IP地址，IPv4格式。

约束：

不填或空字符串，默认在子网（subnet）中自动分配一个未使用的IP作网卡的IP地址。
若指定IP地址，该IP地址必须在子网（subnet）对应的网段内，且未被使用。

ipv6_enable

否

Boolean

是否支持ipv6。取值为true时，表示此网卡支持ipv6。

ipv6_bandwidth

否

Object

绑定的共享带宽信息，详情请参见ipv6_bandwidth字段数据结构说明。

allowed_address_pairs

否

Array of allow_address_pairs objects

IP/Mac对列表，详情请参见表5(扩展属性)。

约束：IP地址不允许为 “0.0.0.0/0”

如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组
如果allowed_address_pairs为“1.1.1.1/0”，表示关闭源目地址检查开关
如果是虚拟IP绑定云服务器，

则mac_address可为空或者填写被绑定云服务器网卡的Mac地址。
被绑定的云服务器网卡allowed_address_pairs的IP地址填“1.1.1.1/0”。

ip_address

否

String

IP地址。

约束：不支持0.0.0.0/0

如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。

mac_address

否

String

MAC地址。

volumetype

是

String

云服务器系统盘对应的磁盘类型，需要与系统所提供的磁盘类型相匹配。

目前支持“SATA”，“SAS”，“GPSSD”，“SSD”，“ESSD”，“GPSSD2”和“ESSD2”。

“SATA”为普通IO云硬盘（已售罄）
“SAS”为高IO云硬盘
“GPSSD”为通用型SSD云硬盘
“SSD”为超高IO云硬盘
“ESSD”为极速IO云硬盘
“GPSSD2”为通用型SSD V2云硬盘
“ESSD2”为极速型SSD V2云硬盘

当指定的云硬盘类型在availability_zone内不存在时，则创建云硬盘失败。

说明：

了解不同磁盘类型的详细信息，请参见磁盘类型及性能介绍。

size

否

Integer

系统盘大小，容量单位为GB，输入大小范围为[1,1024]。

约束：

系统盘大小取值应不小于镜像支持的系统盘的最小值(镜像的min_disk属性)。
若该参数没有指定或者指定为0时，系统盘大小默认取值为镜像中系统盘的最小值(镜像的min_disk属性)。

说明：

镜像系统盘的最小值（镜像的min_disk属性）可在控制台上单击镜像详情查看。或通过调用“查询镜像详情（OpenStack原生）”API获取，详细操作请参考《镜像服务API参考》中“查询镜像详情（OpenStack原生）”章节。

extendparam

否

Object

磁盘的产品信息。

详情请参见创建磁盘的extendparam字段数据结构说明。

cluster_type

否

String

云服务器系统盘对应的磁盘存储类型。

磁盘存储类型枚举值：DSS（专属存储类型）

该参数需要与“cluster_id”配合使用，仅当“cluster_id”不为空时，才可以成功创建专属存储类型的磁盘。

cluster_id

否

String

云服务器系统盘对应的存储池的ID。

hw:passthrough

否

Boolean

设置云硬盘的设备类型：

参数指定为false，创建VBD类型磁盘。
参数指定为true，创建SCSI类型磁盘。
参数未指定或者指定非Boolean类型的字符，默认创建VBD类型磁盘。

说明：

非QingTian规格仅支持设置系统盘为VBD类型。

metadata

否

Object

创建云硬盘的metadata信息，metadata中的key和value长度不大于255个字节。

仅在创建加密盘时使用metadata字段。

详情请参见创建磁盘的metadata字段数据结构说明

iops

否

Integer

为云硬盘配置iops。当“volumetype”设置为GPSSD2、ESSD2类型的云硬盘时，该参数必填，其他类型无需设置。

说明：

了解GPSSD2、ESSD2类型云硬盘的iops，请参见磁盘类型及性能介绍。
仅支持按需计费。

throughput

否

Integer

为云硬盘配置吞吐量，单位是MiB/s。当“volumetype”设置为GPSSD2类型的云硬盘时必填，其他类型不能设置。

说明：

了解GPSSD2类型云硬盘的吞吐量大小范围，请参见磁盘类型及性能介绍。
仅支持按需计费。

volumetype

是

String

云服务器数据盘对应的磁盘类型，需要与系统所提供的磁盘类型相匹配。

目前支持“SATA”，“SAS”，“GPSSD”，“SSD”，“ESSD”，“GPSSD2”和“ESSD2”。

“SATA”为普通IO云硬盘（已售罄）
“SAS”为高IO云硬盘
“GPSSD”为通用型SSD云硬盘
“SSD”为超高IO云硬盘
“ESSD”为极速IO云硬盘
“GPSSD2”为通用型SSD V2云硬盘
“ESSD2”为极速型SSD V2云硬盘

当指定的云硬盘类型在availability_zone内不存在时，则创建云硬盘失败。

说明：

了解不同磁盘类型的详细信息，请参见磁盘类型及性能介绍。

size

是

Integer

数据盘大小，容量单位为GB，输入大小范围为[10,32768]。

如果使用数据盘镜像创建数据盘时，size取值不能小于创建数据盘镜像的源数据盘的大小。

shareable

否

Boolean

是否为共享磁盘。true为共享盘，false为普通云硬盘。

说明：

该字段已废弃，请使用multiattach。

multiattach

否

Boolean

创建共享磁盘的信息。

true：创建的磁盘为共享盘。
false：创建的磁盘为普通云硬盘。

说明：

当参数取值为true时，表明为共享盘，创建的磁盘类型为SCSI。
shareable当前为废弃字段，如果确实需要同时使用shareable字段和multiattach字段，此时，请确保两个字段的参数值相同。当不指定该字段时，系统默认创建普通云硬盘。

hw:passthrough

否

Boolean

设置云硬盘的设备类型：

参数指定为false，创建VBD类型磁盘。
参数指定为true，创建SCSI类型磁盘。
参数未指定或者指定非Boolean类型的字符，默认创建VBD类型磁盘。

说明：

非QingTian规格仅支持设置系统盘为VBD类型。

extendparam

否

Object

磁盘的产品信息。

详情请参见表7。

cluster_type

否

String

云服务器数据盘对应的磁盘存储类型。

磁盘存储类型枚举值：DSS（专属存储类型）

该参数需要与“cluster_id”配合使用，仅当“cluster_id”不为空时，才可以成功创建专属存储类型的磁盘。

cluster_id

否

String

云服务器数据盘对应的存储池的ID。

data_image_id

否

String

数据镜像的ID，UUID格式。

如果使用数据盘镜像创建数据盘，则data_image_id为必选参数，且不支持使用metadata。

metadata

否

Object

创建云硬盘的metadata信息，metadata中的key和value长度不大于255个字节。

仅在创建加密盘时使用metadata字段。

如果使用数据盘镜像创建数据盘，不支持使用metadata。

详情请参见创建磁盘的metadata字段数据结构说明

delete_on_termination

否

Boolean

数据盘随实例释放策略

true：数据盘随实例释放。
false：数据盘不随实例释放。

默认值：false

说明：

该字段仅按需、竞价实例支持。

iops

否

Integer

为云硬盘配置iops。当“volumetype”设置为GPSSD2、ESSD2类型的云硬盘时，该参数必填，其他类型无需设置。

说明：

了解GPSSD2、ESSD2类型云硬盘的iops，请参见磁盘类型及性能介绍。
仅支持按需计费。

throughput

否

Integer

为云硬盘配置吞吐量，单位是MiB/s。当“volumetype”设置为GPSSD2类型的云硬盘时必填，其他类型不能设置。

说明：

了解GPSSD2类型云硬盘的吞吐量大小范围，请参见磁盘类型及性能介绍。
仅支持按需计费。

job_id

String

提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。如何根据job_id来查询Job的执行状态，请参考5.8 查询Job状态。

serverIds

Array of strings

云服务器ID列表。

说明：

通过云服务器ID查询云服务器详情 ，若返回404 可能云服务器还在创建或者已经创建失败。