功能介绍
创建一台或多台按需付费方式的云服务器。
本接口为异步接口，当前创建云服务器请求下发成功后会返回ｊｏｂ＿ｉｄ，此时创建云服务器并没有立即完成，需要通过调用查询任务的执行状态查询ｊｏｂ状态，当Ｊｏｂ状态为 ＳＵＣＣＥＳＳ 时代表云服务器创建成功。
本接口支持在ＨＴＴＰ请求消息头中设置Ｘ－Ｃｌｉｅｎｔ－Ｔｏｋｅｎ请求头，保证请求幂等性。详细信息请参考请求幂等性说明。
调用接口前，您需要了解ＡＰＩ认证鉴权。
调用接口前，您需要提前获取到地区和终端节点。
弹性云服务器的登录鉴权方式包括两种：密钥对、密码。为安全起见，推荐使用密钥对方式。
密钥对
指使用密钥对作为弹性云服务器的鉴权方式。
接口调用方法：使用ｋｅｙ＿ｎａｍｅ字段，指定弹性云服务器登录时使用的密钥文件。
密码
指使用设置初始密码方式作为弹性云服务器的鉴权方式，此时，您可以通过用户名密码方式登录弹性云服务器，Ｌｉｎｕｘ操作系统时为ｒｏｏｔ用户的初始密码，Ｗｉｎｄｏｗｓ操作系统时为Ａｄｍｉｎｉｓｔｒａｔｏｒ用户的初始密码。
接口调用方法：使用ａｄｍｉｎＰａｓｓ字段，指定管理员账号的初始登录密码，ａｄｍｉｎＰａｓｓ字段的使用方法请参见表３。对于镜像已安装Ｃｌｏｕｄ－ｉｎｉｔ的Ｌｉｎｕｘ云服务器，如果需要使用密文密码，可以使用ｕｓｅｒ＿ｄａｔａ字段进行密码注入，具体请参见表３。
说明：
对于安装Ｃｌｏｕｄ－ｉｎｉｔ镜像的Ｌｉｎｕｘ云服务器，若指定ｕｓｅｒ＿ｄａｔａ字段，则该ａｄｍｉｎＰａｓｓ字段无效。
镜像密码
使用Ｌｉｎｕｘ操作系统私有镜像创建云服务器，支持使用私有镜像的密码。
接口调用方法：使用镜像密码，则无需指定ｋｅｙ＿ｎａｍｅ、ａｄｍｉｎＰａｓｓ字段。
接口约束
创建按需计费云服务器时，系统会自动匹配适用的代金券进行使用。
调试
您可以在ＡＰＩ Ｅｘｐｌｏｒｅｒ中调试该接口。
ＵＲＩ
ＰＯＳＴ ／ｖ１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ
参数说明请参见表１。
表１ 参数说明
参数
是否必选
描述
ｐｒｏｊｅｃｔ＿ｉｄ
是
项目ＩＤ。
获取方法请参见获取项目ＩＤ。
请求消息
请求参数
请求参数如表２所示。
表２ 请求参数
参数
是否必选
参数类型
描述
ｓｅｒｖｅｒ
是
Ｏｂｊｅｃｔ
弹性云服务器信息，请参见表３。
ｄｒｙ＿ｒｕｎ
否
Ｂｏｏｌｅａｎ
是否只预检此次请求，默认为ｆａｌｓｅ。
ｔｒｕｅ：发送检查请求，不会创建实例。检查项包括是否填写了必需参数、请求格式等。
如果检查不通过，则返回对应错误。
如果检查通过，则返回２０２状态码。
ｆａｌｓｅ：发送正常请求，通过检查后并且执行创建云服务器请求。
表３ 创建云服务器请求参数说明
参数
是否必选
参数类型
描述
ｉｍａｇｅＲｅｆ
是
Ｓｔｒｉｎｇ
待创建云服务器的系统镜像，需要指定已创建镜像的ＩＤ，ＩＤ格式为通用识别码（Ｕｎｉｖｅｒｓａｌｌｙ Ｕｎｉｑｕｅ Ｉｄｅｎｔｉｆｉｅｒ，简称ＵＵＩＤ）。
镜像的ＩＤ可以从控制台或者参考《镜像服务ＡＰＩ参考》的“查询镜像列表”的章节获取。
ｆｌａｖｏｒＲｅｆ
是
Ｓｔｒｉｎｇ
待创建云服务器的系统规格的ＩＤ。
已上线的规格请参见《弹性云服务器产品介绍》的“实例类型与规格”章节。
ｎａｍｅ
是
Ｓｔｒｉｎｇ
云服务器名称。
创建的云服务器数量（ｃｏｕｎｔ字段对应的值）大于１时，可以使用“自动排序”和“正则排序”设置有序的云服务器名称。
请参考创建多台云服务器云主机时怎样设置有序的云服务器云主机名称？
取值范围：
只能由中文字符、英文字母、数字及“＿”、“－”、“．”组成，且长度为［１－１２８］个英文字符或［１－６４］个中文字符。
创建的云服务器数量（ｃｏｕｎｔ字段对应的值）大于１时，为区分不同云服务器，创建过程中系统会自动在名称后加“－００００”的类似标记。若用户在名称后已指定“－００００”的类似标记，系统将从该标记后继续顺序递增编号。故此时名称的长度为［１－５９］个字符。
说明：
云服务器虚拟机内部（ｈｏｓｔｎａｍｅ）命名规则遵循 ＲＦＣ ９５２和ＲＦＣ １１２３命名规范，建议使用ａ－ｚ或０－９以及中划线＂－＂组成的名称命名，＂＿＂将在弹性云服务器内部默认转化为＂－＂。
ｕｓｅｒ＿ｄａｔａ
否
Ｓｔｒｉｎｇ
创建云服务器过程中待注入实例自定义数据。支持注入文本、文本文件。
说明：
ｕｓｅｒ＿ｄａｔａ的值为ｂａｓｅ６４编码之后的内容。
注入内容（编码之前的内容）更大长度为３２Ｋ。
更多关于待注入实例自定义数据的信息，请参见《弹性云服务器用户指南 》的“用户数据注入”章节。
示例：
ｂａｓｅ６４编码前：
Ｌｉｎｕｘ服务器：
＃！／ｂｉｎ／ｂａｓｈ
ｅｃｈｏ ｕｓｅｒ＿ｔｅｓｔ ＞ ／ｈｏｍｅ／ｕｓｅｒ．ｔｘｔ
Ｗｉｎｄｏｗｓ服务器：
ｒｅｍ ｃｍｄ
ｅｃｈｏ １１１ ＞ ｃ：＼ａａａ．ｔｘｔ
ｂａｓｅ６４编码后：
Ｌｉｎｕｘ服务器：
ＩｙＥｖＹｍｌｕＬ２Ｊｈｃ２ｇＫＺＷＮｏｂｙＢ１ｃ２ＶｙＸ３Ｒｌｃ３ＱｇＰｉＡｖａＧ９ｔＺＳ９１ｃ２ＶｙＬｎＲ４ｄＡ＝＝
Ｗｉｎｄｏｗｓ服务器：
ｃｍＶｔＩＧＮｔＺＡｐｌＹ２ｈｖＩＤＥｘＭＳＡ＋ＩＧＭ６ＸＧＦｈＹＳ５０ｅＨＱ＝
ａｄｍｉｎＰａｓｓ
否
Ｓｔｒｉｎｇ
如果需要使用密码方式登录云服务器，可使用ａｄｍｉｎＰａｓｓ字段指定云服务器管理员账户初始登录密码。其中，Ｌｉｎｕｘ管理员账户为ｒｏｏｔ，Ｗｉｎｄｏｗｓ管理员账户为Ａｄｍｉｎｉｓｔｒａｔｏｒ。
密码复杂度要求：
长度为８－２６位。
密码至少必须包含大写字母、小写字母、数字和特殊字符（！＠＄％＾－＿＝＋［｛｝］：，．／？～＃＊）中的三种。
密码不能包含用户名或用户名的逆序。
Ｗｉｎｄｏｗｓ系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。
ｋｅｙ＿ｎａｍｅ
否
Ｓｔｒｉｎｇ
如果需要使用ＳＳＨ密钥方式登录云服务器，请指定已创建密钥的名称。
密钥可以通过密钥创建接口进行创建（请参见 创建和导入ＳＳＨ密钥），或使用ＳＳＨ密钥查询接口查询已有的密钥（请参见查询ＳＳＨ密钥列表 ）。
ｖｐｃｉｄ
是
Ｓｔｒｉｎｇ
待创建云服务器所属虚拟私有云（简称ＶＰＣ），需要指定已创建ＶＰＣ的ＩＤ，ＵＵＩＤ格式。
ＶＰＣ的ＩＤ可以从控制台或者参考《虚拟私有云接口参考》的“查询ＶＰＣ”章节获取。
ｎｉｃｓ
是
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
待创建云服务器的网卡信息。详情请参见表４。
约束：
主网卡对应的网络（ｎｅｔｗｏｒｋ）必须属于ｖｐｃｉｄ对应的ＶＰＣ。用户创建网卡时，指定的张网卡信息为主网卡。
需要指定ｖｐｃｉｄ对应ＶＰＣ下已创建的子网（ｓｕｂｎｅｔ）的网络ＩＤ，ＵＵＩＤ格式。
当前单个云服务器支持最多挂载１２张网卡。
不同的规格对网卡上限有一定的区别，参考 规格清单。
ｐｕｂｌｉｃｉｐ
否
Ｏｂｊｅｃｔ
配置云服务器的弹性公网ＩＰ信息，弹性公网ＩＰ有三种配置方式。
不使用（无该字段）
自动分配，需要指定新创建弹性公网ＩＰ的信息
使用已有，需要指定已创建弹性公网ＩＰ的信息
详情请参见表１。
ｃｏｕｎｔ
否
Ｉｎｔｅｇｅｒ
创建云服务器数量。
约束：
不传该字段时默认取值为１。
租户的配额足够时，更大值为５００。
ｉｓＡｕｔｏＲｅｎａｍｅ
否
Ｂｏｏｌｅａｎ
批量创建时是否使用相同的名称。默认为Ｆａｌｓｅ，当ｃｏｕｎｔ大于１的时候该参数生效。
Ｔｒｕｅ，表示使用相同名称。
Ｆａｌｓｅ，表示自动增加后缀。
ｒｏｏｔ＿ｖｏｌｕｍｅ
是
Ｏｂｊｅｃｔ
云服务器对应系统盘相关配置。
详情请参见表６。
ｄａｔａ＿ｖｏｌｕｍｅｓ
否
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
云服务器对应数据盘相关配置。每一个数据结构代表一块待创建的数据盘。
约束：目前云服务器最多可挂载５９块数据盘（部分规格只支持２３块数据盘）
详情请参见表７。
ｓｅｃｕｒｉｔｙ＿ｇｒｏｕｐｓ
否
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
云服务器对应安全组信息。
约束：当该值指定为空时，默认给云服务器绑定ｄｅｆａｕｌｔ安全组。
详情请参见表２。
ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ
否
Ｓｔｒｉｎｇ
待创建云服务器所在的可用区，需要指定可用分区名称。
说明：
如果为空，会自动指定一个符合要求的可用区。
如果在专属主机上创建云服务器，需指定云服务器与专属主机所在可用区一致。
可通过接口 查询可用区列表 获取，也可参考地区和终端节点获取。
ｂａｔｃｈ＿ｃｒｅａｔｅ＿ｉｎ＿ｍｕｌｔｉ＿ａｚ
否
Ｂｏｏｌｅａｎ
是否支持随机多ＡＺ部署，默认为ｆａｌｓｅ。
ｔｒｕｅ：批量创建的ｅｃｓ部署在多个ＡＺ上
ｆａｌｓｅ：批量创建的ｅｃｓ部署在单个ＡＺ上
当ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ为空时该字段生效。
ｅｘｔｅｎｄｐａｒａｍ
否
Ｏｂｊｅｃｔ
创建云服务器附加信息。
详情请参见表８。
ｍｅｔａｄａｔａ
否
Ｍａｐ＜Ｓｔｒｉｎｇ，Ｓｔｒｉｎｇ＞
创建云服务器元数据。
可以通过元数据自定义键值对。
说明：
如果元数据中包含了敏感数据，您应当采取适当的措施来保护敏感数据，比如限制访问范围、加密等。
最多可注入１０对键值（Ｋｅｙ／Ｖａｌｕｅ）。
主键（Ｋｅｙ）只能由大写字母（Ａ－Ｚ）、小写字母（ａ－ｚ）、数字（０－９）、中划线（－）、下划线（＿）、冒号（：）、空格（ ）和小数点（．）组成，长度为［１－２５５］个字符。
值（ｖａｌｕｅ）更大长度为２５５个字符。
系统预留键值对请参见表１１。
ｏｓ：ｓｃｈｅｄｕｌｅｒ＿ｈｉｎｔｓ
否
Ｏｂｊｅｃｔ
云服务器调度信息，例如设置云服务器组。
详情请参见表１２。
ｔａｇｓ
否
Ａｒｒａｙ ｏｆ ｓｔｒｉｎｇｓ
弹性云服务器的标签。
标签的格式为“ｋｅｙ．ｖａｌｕｅ”。其中，ｋｅｙ的长度不超过３６个字符，ｖａｌｕｅ的长度不超过４３个字符。
标签命名时，需满足如下要求：
标签的ｋｅｙ值只能包含大写字母（Ａ～Ｚ）、小写字母（ａ～ｚ）、数字（０－９）、下划线（＿）、中划线（－）以及中文字符。
标签的ｖａｌｕｅ值只能包含大写字母（Ａ～Ｚ）、小写字母（ａ～ｚ）、数字（０－９）、下划线（＿）、中划线（－）、小数点（．）以及中文字符。
说明：
创建弹性云服务器时，一台弹性云服务器最多可以添加１０个标签。
公有云新增ｓｅｒｖｅｒ＿ｔａｇｓ字段，该字段与ｔａｇｓ字段功能相同，支持的ｋｅｙ、ｖａｌｕｅ取值范围更广，建议使用ｓｅｒｖｅｒ＿ｔａｇｓ字段。
ｓｅｒｖｅｒ＿ｔａｇｓ
否
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
弹性云服务器的标签。详情请参见表１４。
说明：
创建弹性云服务器时，一台弹性云服务器最多可以添加１０个标签。
公有云新增ｓｅｒｖｅｒ＿ｔａｇｓ字段，该字段与ｔａｇｓ字段功能相同，支持的ｋｅｙ、ｖａｌｕｅ取值范围更广，建议使用ｓｅｒｖｅｒ＿ｔａｇｓ字段。
ｄｅｓｃｒｉｐｔｉｏｎ
否
Ｓｔｒｉｎｇ
云服务器描述信息，默认为空字符串。
长度最多允许８５个字符。
不能包含“＜” 和 “＞”。
ａｕｔｏ＿ｔｅｒｍｉｎａｔｅ＿ｔｉｍｅ
否
Ｓｔｒｉｎｇ
定时删除时间。
按照ＩＳＯ８６０１标准表示，并使用ＵＴＣ ＋０时间，格式为ｙｙｙｙ－ＭＭ－ｄｄＴＨＨ：ｍｍ：ｓｓＺ。
如果秒（ｓｓ）取值不是 ００，则自动取为当前分钟（ｍｍ）开始时。
最短定时删除时间为当前时间半小时之后。
最长定时删除时间不能超过当前时间三年。
示例：２０２０－０９－２５Ｔ１２：０５：００Ｚ
说明：
仅按需实例支持设置定时删除时间。
该字段当前仅在华北－北京四、华南－广州区域生效。
ｃｐｕ＿ｏｐｔｉｏｎｓ
否
Ｏｂｊｅｃｔ
自定义ＣＰＵ选项。
详情请参见表８。
表４ ｎｉｃｓ字段数据结构说明
参数
是否必选
参数类型
描述
ｓｕｂｎｅｔ＿ｉｄ
是
Ｓｔｒｉｎｇ
待创建云服务器所在的子网信息。
需要指定ｖｐｃｉｄ对应ＶＰＣ下已创建的子网（ｓｕｂｎｅｔ）的网络ＩＤ，ＵＵＩＤ格式。
可以通过ＶＰＣ服务查询子网列表接口查询。
ｉｐ＿ａｄｄｒｅｓｓ
否
Ｓｔｒｉｎｇ
待创建云服务器网卡的ＩＰ地址，ＩＰｖ４格式。
约束：
不填或空字符串，默认在子网（ｓｕｂｎｅｔ）中自动分配一个未使用的ＩＰ作网卡的ＩＰ地址。
若指定ＩＰ地址，该ＩＰ地址必须在子网（ｓｕｂｎｅｔ）对应的网段内，且未被使用。
ｉｐｖ６＿ｅｎａｂｌｅ
否
Ｂｏｏｌｅａｎ
是否支持ｉｐｖ６。取值为ｔｒｕｅ时，表示此网卡支持ｉｐｖ６。
ｉｐｖ６＿ｂａｎｄｗｉｄｔｈ
否
Ｏｂｊｅｃｔ
绑定的共享带宽信息，详情请参见ｉｐｖ６＿ｂａｎｄｗｉｄｔｈ字段数据结构说明。
ａｌｌｏｗｅｄ＿ａｄｄｒｅｓｓ＿ｐａｉｒｓ
否
Ａｒｒａｙ ｏｆ ａｌｌｏｗ＿ａｄｄｒｅｓｓ＿ｐａｉｒｓ ｏｂｊｅｃｔｓ
ＩＰ／Ｍａｃ对列表，详情请参见表５（扩展属性）。
约束：ＩＰ地址不允许为 “０．０．０．０／０”
如果ａｌｌｏｗｅｄ＿ａｄｄｒｅｓｓ＿ｐａｉｒｓ配置地址池较大的ＣＩＤＲ（掩码小于２４位），建议为该ｐｏｒｔ配置一个单独的安全组
如果ａｌｌｏｗｅｄ＿ａｄｄｒｅｓｓ＿ｐａｉｒｓ为“１．１．１．１／０”，表示关闭源目地址检查开关
如果是虚拟ＩＰ绑定云服务器，
则ｍａｃ＿ａｄｄｒｅｓｓ可为空或者填写被绑定云服务器网卡的Ｍａｃ地址。
被绑定的云服务器网卡ａｌｌｏｗｅｄ＿ａｄｄｒｅｓｓ＿ｐａｉｒｓ的ＩＰ地址填“１．１．１．１／０”。
表５ ａｌｌｏｗ＿ａｄｄｒｅｓｓ＿ｐａｉｒｓ对象
名称
是否必选
参数类型
说明
ｉｐ＿ａｄｄｒｅｓｓ
否
Ｓｔｒｉｎｇ
ＩＰ地址。
约束：不支持０．０．０．０／０
如果ａｌｌｏｗｅｄ＿ａｄｄｒｅｓｓ＿ｐａｉｒｓ配置地址池较大的ＣＩＤＲ（掩码小于２４位），建议为该ｐｏｒｔ配置一个单独的安全组。
ｍａｃ＿ａｄｄｒｅｓｓ
否
Ｓｔｒｉｎｇ
ＭＡＣ地址。
表６ ｒｏｏｔ＿ｖｏｌｕｍｅ字段数据结构说明
参数
是否必选
参数类型
描述
ｖｏｌｕｍｅｔｙｐｅ
是
Ｓｔｒｉｎｇ
云服务器系统盘对应的磁盘类型，需要与系统所提供的磁盘类型相匹配。
目前支持“ＳＡＴＡ”，“ＳＡＳ”，“ＧＰＳＳＤ”，“ＳＳＤ”，“ＥＳＳＤ”，“ＧＰＳＳＤ２”和“ＥＳＳＤ２”。
“ＳＡＴＡ”为普通ＩＯ云硬盘（已售罄）
“ＳＡＳ”为高ＩＯ云硬盘
“ＧＰＳＳＤ”为通用型ＳＳＤ云硬盘
“ＳＳＤ”为超高ＩＯ云硬盘
“ＥＳＳＤ”为极速ＩＯ云硬盘
“ＧＰＳＳＤ２”为通用型ＳＳＤ Ｖ２云硬盘
“ＥＳＳＤ２”为极速型ＳＳＤ Ｖ２云硬盘
当指定的云硬盘类型在ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ内不存在时，则创建云硬盘失败。
说明：
了解不同磁盘类型的详细信息，请参见磁盘类型及性能介绍。
ｓｉｚｅ
否
Ｉｎｔｅｇｅｒ
系统盘大小，容量单位为ＧＢ，输入大小范围为［１，１０２４］。
约束：
系统盘大小取值应不小于镜像支持的系统盘的最小值（镜像的ｍｉｎ＿ｄｉｓｋ属性）。
若该参数没有指定或者指定为０时，系统盘大小默认取值为镜像中系统盘的最小值（镜像的ｍｉｎ＿ｄｉｓｋ属性）。
说明：
镜像系统盘的最小值（镜像的ｍｉｎ＿ｄｉｓｋ属性）可在控制台上单击镜像详情查看。或通过调用“查询镜像详情（ＯｐｅｎＳｔａｃｋ原生）”ＡＰＩ获取，详细操作请参考《镜像服务ＡＰＩ参考》中“查询镜像详情（ＯｐｅｎＳｔａｃｋ原生）”章节。
ｅｘｔｅｎｄｐａｒａｍ
否
Ｏｂｊｅｃｔ
磁盘的产品信息。
详情请参见创建磁盘的ｅｘｔｅｎｄｐａｒａｍ字段数据结构说明。
ｃｌｕｓｔｅｒ＿ｔｙｐｅ
否
Ｓｔｒｉｎｇ
云服务器系统盘对应的磁盘存储类型。
磁盘存储类型枚举值：ＤＳＳ（专属存储类型）
该参数需要与“ｃｌｕｓｔｅｒ＿ｉｄ”配合使用，仅当“ｃｌｕｓｔｅｒ＿ｉｄ”不为空时，才可以成功创建专属存储类型的磁盘。
ｃｌｕｓｔｅｒ＿ｉｄ
否
Ｓｔｒｉｎｇ
云服务器系统盘对应的存储池的ＩＤ。
ｈｗ：ｐａｓｓｔｈｒｏｕｇｈ
否
Ｂｏｏｌｅａｎ
设置云硬盘的设备类型：
参数指定为ｆａｌｓｅ，创建ＶＢＤ类型磁盘。
参数指定为ｔｒｕｅ，创建ＳＣＳＩ类型磁盘。
参数未指定或者指定非Ｂｏｏｌｅａｎ类型的字符，默认创建ＶＢＤ类型磁盘。
说明：
非ＱｉｎｇＴｉａｎ规格仅支持设置系统盘为ＶＢＤ类型。
ｍｅｔａｄａｔａ
否
Ｏｂｊｅｃｔ
创建云硬盘的ｍｅｔａｄａｔａ信息，ｍｅｔａｄａｔａ中的ｋｅｙ和ｖａｌｕｅ长度不大于２５５个字节。
仅在创建加密盘时使用ｍｅｔａｄａｔａ字段。
详情请参见创建磁盘的ｍｅｔａｄａｔａ字段数据结构说明
ｉｏｐｓ
否
Ｉｎｔｅｇｅｒ
为云硬盘配置ｉｏｐｓ。当“ｖｏｌｕｍｅｔｙｐｅ”设置为ＧＰＳＳＤ２、ＥＳＳＤ２类型的云硬盘时，该参数必填，其他类型无需设置。
说明：
了解ＧＰＳＳＤ２、ＥＳＳＤ２类型云硬盘的ｉｏｐｓ，请参见磁盘类型及性能介绍。
仅支持按需计费。
ｔｈｒｏｕｇｈｐｕｔ
否
Ｉｎｔｅｇｅｒ
为云硬盘配置吞吐量，单位是ＭｉＢ／ｓ。当“ｖｏｌｕｍｅｔｙｐｅ”设置为ＧＰＳＳＤ２类型的云硬盘时必填，其他类型不能设置。
说明：
了解ＧＰＳＳＤ２类型云硬盘的吞吐量大小范围，请参见磁盘类型及性能介绍。
仅支持按需计费。
表７ ｄａｔａ＿ｖｏｌｕｍｅｓ字段数据结构说明
参数
是否必选
参数类型
描述
ｖｏｌｕｍｅｔｙｐｅ
是
Ｓｔｒｉｎｇ
云服务器数据盘对应的磁盘类型，需要与系统所提供的磁盘类型相匹配。
目前支持“ＳＡＴＡ”，“ＳＡＳ”，“ＧＰＳＳＤ”，“ＳＳＤ”，“ＥＳＳＤ”，“ＧＰＳＳＤ２”和“ＥＳＳＤ２”。
“ＳＡＴＡ”为普通ＩＯ云硬盘（已售罄）
“ＳＡＳ”为高ＩＯ云硬盘
“ＧＰＳＳＤ”为通用型ＳＳＤ云硬盘
“ＳＳＤ”为超高ＩＯ云硬盘
“ＥＳＳＤ”为极速ＩＯ云硬盘
“ＧＰＳＳＤ２”为通用型ＳＳＤ Ｖ２云硬盘
“ＥＳＳＤ２”为极速型ＳＳＤ Ｖ２云硬盘
当指定的云硬盘类型在ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ内不存在时，则创建云硬盘失败。
说明：
了解不同磁盘类型的详细信息，请参见磁盘类型及性能介绍。
ｓｉｚｅ
是
Ｉｎｔｅｇｅｒ
数据盘大小，容量单位为ＧＢ，输入大小范围为［１０，３２７６８］。
如果使用数据盘镜像创建数据盘时，ｓｉｚｅ取值不能小于创建数据盘镜像的源数据盘的大小。
ｓｈａｒｅａｂｌｅ
否
Ｂｏｏｌｅａｎ
是否为共享磁盘。ｔｒｕｅ为共享盘，ｆａｌｓｅ为普通云硬盘。
说明：
该字段已废弃，请使用ｍｕｌｔｉａｔｔａｃｈ。
ｍｕｌｔｉａｔｔａｃｈ
否
Ｂｏｏｌｅａｎ
创建共享磁盘的信息。
ｔｒｕｅ：创建的磁盘为共享盘。
ｆａｌｓｅ：创建的磁盘为普通云硬盘。
说明：
ｓｈａｒｅａｂｌｅ当前为废弃字段，如果确实需要同时使用ｓｈａｒｅａｂｌｅ字段和ｍｕｌｔｉａｔｔａｃｈ字段，此时，请确保两个字段的参数值相同。当不指定该字段时，系统默认创建普通云硬盘。
ｈｗ：ｐａｓｓｔｈｒｏｕｇｈ
否
Ｂｏｏｌｅａｎ
设置云硬盘的设备类型：
参数指定为ｆａｌｓｅ，创建ＶＢＤ类型磁盘。
参数指定为ｔｒｕｅ，创建ＳＣＳＩ类型磁盘。
参数未指定或者指定非Ｂｏｏｌｅａｎ类型的字符，默认创建ＶＢＤ类型磁盘。
说明：
非ＱｉｎｇＴｉａｎ规格仅支持设置系统盘为ＶＢＤ类型。
ｅｘｔｅｎｄｐａｒａｍ
否
Ｏｂｊｅｃｔ
磁盘的产品信息。
详情请参见表７。
ｃｌｕｓｔｅｒ＿ｔｙｐｅ
否
Ｓｔｒｉｎｇ
云服务器数据盘对应的磁盘存储类型。
磁盘存储类型枚举值：ＤＳＳ（专属存储类型）
该参数需要与“ｃｌｕｓｔｅｒ＿ｉｄ”配合使用，仅当“ｃｌｕｓｔｅｒ＿ｉｄ”不为空时，才可以成功创建专属存储类型的磁盘。
ｃｌｕｓｔｅｒ＿ｉｄ
否
Ｓｔｒｉｎｇ
云服务器数据盘对应的存储池的ＩＤ。
ｄａｔａ＿ｉｍａｇｅ＿ｉｄ
否
Ｓｔｒｉｎｇ
数据镜像的ＩＤ，ＵＵＩＤ格式。
如果使用数据盘镜像创建数据盘，则ｄａｔａ＿ｉｍａｇｅ＿ｉｄ为必选参数，且不支持使用ｍｅｔａｄａｔａ。
ｍｅｔａｄａｔａ
否
Ｏｂｊｅｃｔ
创建云硬盘的ｍｅｔａｄａｔａ信息，ｍｅｔａｄａｔａ中的ｋｅｙ和ｖａｌｕｅ长度不大于２５５个字节。
仅在创建加密盘时使用ｍｅｔａｄａｔａ字段。
如果使用数据盘镜像创建数据盘，不支持使用ｍｅｔａｄａｔａ。
详情请参见创建磁盘的ｍｅｔａｄａｔａ字段数据结构说明
ｄｅｌｅｔｅ＿ｏｎ＿ｔｅｒｍｉｎａｔｉｏｎ
否
Ｂｏｏｌｅａｎ
数据盘随实例释放策略
ｔｒｕｅ：数据盘随实例释放。
ｆａｌｓｅ：数据盘不随实例释放。
默认值：ｆａｌｓｅ
说明：
该字段仅按需、竞价实例支持。
ｉｏｐｓ
否
Ｉｎｔｅｇｅｒ
为云硬盘配置ｉｏｐｓ。当“ｖｏｌｕｍｅｔｙｐｅ”设置为ＧＰＳＳＤ２、ＥＳＳＤ２类型的云硬盘时，该参数必填，其他类型无需设置。
说明：
了解ＧＰＳＳＤ２、ＥＳＳＤ２类型云硬盘的ｉｏｐｓ，请参见磁盘类型及性能介绍。
仅支持按需计费。
ｔｈｒｏｕｇｈｐｕｔ
否
Ｉｎｔｅｇｅｒ
为云硬盘配置吞吐量，单位是ＭｉＢ／ｓ。当“ｖｏｌｕｍｅｔｙｐｅ”设置为ＧＰＳＳＤ２类型的云硬盘时必填，其他类型不能设置。
说明：
了解ＧＰＳＳＤ２类型云硬盘的吞吐量大小范围，请参见磁盘类型及性能介绍。
仅支持按需计费。
表８ ｃｐｕ＿ｏｐｔｉｏｎｓ数据结构说明
参数
是否必选
参数类型
描述
ｈｗ：ｃｐｕ＿ｔｈｒｅａｄｓ
否
ｉｎｔｅｇｅｒ
用于控制ＣＰＵ是否开启超线程。
取值范围：１，２。
１： 关闭超线程。
２： 打开超线程。
需要同时满足如下条件，才能设置为“关闭超线程”：
只能在实例创建或者ｒｅｓｉｚｅ时指定。
只有目标ｆｌａｖｏｒ的ｅｘｔｒａ＿ｓｐｅｃｓ参数：
存在“ｈｗ：ｃｐｕ＿ｐｏｌｉｃｙ”并取值为“ｄｅｄｉｃａｔｅｄ”。
存在“ｈｗ：ｃｐｕ＿ｔｈｒｅａｄｓ”并取值为“２”。
响应消息
参数
参数类型
描述
ｊｏｂ＿ｉｄ
Ｓｔｒｉｎｇ
提交任务成功后返回的任务ＩＤ，用户可以使用该ＩＤ对任务执行情况进行查询。如何根据ｊｏｂ＿ｉｄ来查询Ｊｏｂ的执行状态，请参考５．８ 查询Ｊｏｂ状态。
ｓｅｒｖｅｒＩｄｓ
Ａｒｒａｙ ｏｆ ｓｔｒｉｎｇｓ
云服务器ＩＤ列表。
说明：
通过云服务器ＩＤ查询云服务器详情 ，若返回４０４ 可能云服务器还在创建或者已经创建失败。
异常响应请参考响应（任务类），异常响应要素说明。
请求示例
创建一台按需计费云服务器，操作系统为ＣｅｎｔＯＳ ７．６ ６４ｂｉｔ，４Ｕ８Ｇ，磁盘类型为“ＳＳＤ”，绑定１０Ｍ的按带宽计费的弹性公网ＩＰ，采用密钥方式登录鉴权。
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ
｛
＂ｓｅｒｖｅｒ＂： ｛
＂ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ＂：＂ａｚ１－ｄｃ１＂，
＂ｎａｍｅ＂： ＂ｎｅｗｓｅｒｖｅｒ＂，
＂ｉｍａｇｅＲｅｆ＂： ＂６７ｆ４３３ｄ８－ｅｄ０ｅ－４３２１－ａ８ａ２－ａ７１８３８５３９ｅ０９＂，
＂ｒｏｏｔ＿ｖｏｌｕｍｅ＂： ｛
＂ｖｏｌｕｍｅｔｙｐｅ＂： ＂ＳＳＤ＂
｝，
＂ｄａｔａ＿ｖｏｌｕｍｅｓ＂： ［
｛
＂ｖｏｌｕｍｅｔｙｐｅ＂： ＂ＳＳＤ＂，
＂ｓｉｚｅ＂： １００，
＂ｍｕｌｔｉａｔｔａｃｈ＂： ｔｒｕｅ，
＂ｈｗ：ｐａｓｓｔｈｒｏｕｇｈ＂： ｔｒｕｅ
｝
］，
＂ｆｌａｖｏｒＲｅｆ＂： ＂ｓ３．ｘｌａｒｇｅ．２＂，
＂ｖｐｃｉｄ＂： ＂０ｄａｅ２６ｃ９－９ａ７０－４３９２－９３ｆ３－８７ｄ５３１１５ｄ１７１＂，
＂ｓｅｃｕｒｉｔｙ＿ｇｒｏｕｐｓ＂： ［
｛
＂ｉｄ＂： ＂５０７ｃａ４８ｆ－８１４ｃ－４２９３－８７０６－３００５６４ｄ５４６２０＂
｝
］，
＂ｎｉｃｓ＂： ［
｛
＂ｓｕｂｎｅｔ＿ｉｄ＂： ＂１５７ｅｅ７８９－０３ｅａ－４５ｂ１－ａ６９８－７６ｃ９２６６０ｄｄ８３＂
｝
］，
＂ｐｕｂｌｉｃｉｐ＂： ｛
＂ｅｉｐ＂： ｛
＂ｉｐｔｙｐｅ＂： ＂５＿ｂｇｐ＂，
＂ｂａｎｄｗｉｄｔｈ＂： ｛
＂ｓｉｚｅ＂： １０，
＂ｓｈａｒｅｔｙｐｅ＂： ＂ＰＥＲ＂
｝
｝
｝，
＂ｋｅｙ＿ｎａｍｅ＂： ＂ｓｓｈｋｅｙ－１２３＂，
＂ｃｏｕｎｔ＂： １，
＂ｅｘｔｅｎｄｐａｒａｍ＂： ｛
＂ｅｎｔｅｒｐｒｉｓｅ＿ｐｒｏｊｅｃｔ＿ｉｄ＂： ＂ｆ８ｅ０ｅｃｃ８－３８２５－４ｅｅ８－９５９６－ｆｂ４２５８ｆｆｄｃｂｂ＂
｝，
＂ｓｅｒｖｅｒ＿ｔａｇｓ＂： ［
｛
＂ｋｅｙ＂： ＂ｋｅｙ１＂，
＂ｖａｌｕｅ＂： ＂ｖａｌｕｅ１＂
｝
］，
＂ｍｅｔａｄａｔａ＂： ｛
＂ｏｐ＿ｓｖｃ＿ｕｓｅｒｉｄ＂： ＂８ｅａ６５ｆ４０９９ｂａ４１２８８３ｅ２ａ０ｄａ７２ｂ９６８７３＂，
＂ａｇｅｎｃｙ＿ｎａｍｅ＂： ＂ｔｅｓｔ＂
｝
｝
｝
发送预校验请求，检查创建弹性云服务器的请求消息是否填写了必选参数，请求格式是否正确。
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ１／｛ｐｒｏｊｅｃｔ＿ｉｄ｝／ｃｌｏｕｄｓｅｒｖｅｒｓ
｛
＂ｄｒｙ＿ｒｕｎ＂： ｔｒｕｅ，
＂ｓｅｒｖｅｒ＂： ｛
＂ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ＂：＂ａｚ１－ｄｃ１＂，
＂ｎａｍｅ＂： ＂ｎｅｗｓｅｒｖｅｒ＂，
＂ｉｍａｇｅＲｅｆ＂： ＂１１８９ｅｆｂｆ－ｄ４８ｂ－４６ａｄ－ａ８２３－９４ｂ９４２ｅ２ａ０００＂，
＂ｒｏｏｔ＿ｖｏｌｕｍｅ＂： ｛
＂ｖｏｌｕｍｅｔｙｐｅ＂： ＂ＳＳＤ＂
｝，
＂ｄａｔａ＿ｖｏｌｕｍｅｓ＂： ［
｛
＂ｖｏｌｕｍｅｔｙｐｅ＂： ＂ＳＳＤ＂，
＂ｓｉｚｅ＂： １００，
＂ｍｕｌｔｉａｔｔａｃｈ＂： ｔｒｕｅ，
＂ｈｗ：ｐａｓｓｔｈｒｏｕｇｈ＂： ｔｒｕｅ
｝
］，
＂ｆｌａｖｏｒＲｅｆ＂： ＂ｓ３．ｘｌａｒｇｅ．２＂，
＂ｖｐｃｉｄ＂： ＂０ｄａｅ２６ｃ９－９ａ７０－４３９２－９３ｆ３－８７ｄ５３１１５ｄ１７１＂，
＂ｓｅｃｕｒｉｔｙ＿ｇｒｏｕｐｓ＂： ［
｛
＂ｉｄ＂： ＂５０７ｃａ４８ｆ－８１４ｃ－４２９３－８７０６－３００５６４ｄ５４６２０＂
｝
］，
＂ｎｉｃｓ＂： ［
｛
＂ｓｕｂｎｅｔ＿ｉｄ＂： ＂１５７ｅｅ７８９－０３ｅａ－４５ｂ１－ａ６９８－７６ｃ９２６６０ｄｄ８３＂
｝
］，
＂ｋｅｙ＿ｎａｍｅ＂： ＂ｓｓｈｋｅｙ－１２３＂，
＂ｃｏｕｎｔ＂： １
｝
｝
响应示例
｛
＂ｊｏｂ＿ｉｄ＂： ＂ｆｆ８０８０８２７３９３３４ｄ８０１７３９４１５６７ｆ２１ｄ４ｆ＂，
＂ｓｅｒｖｅｒＩｄｓ＂： ［
＂１１８２５８ｃ５－０ｃ６ａ－４ｅ７３－８ｂ５１－８ｄ１ｅａ３２７２ｅ１ｂ＂，
＂ｅ５１ｂ９ｅ２０－７０８８－４９１４－ａ４ｆ３－６ｃ７６ｂｃｆｅｄ０ｂｅ＂
］
｝
或
｛
＂ｅｒｒｏｒ＂： ｛
＂ｃｏｄｅ＂： ＂ｒｅｑｕｅｓｔ ｂｏｄｙ ｉｓ ｉｌｌｅｇａｌ．＂，
＂ｍｅｓｓａｇｅ＂： ＂Ｅｃｓ．０００５＂
｝
｝
或
｛
＂ｅｒｒｏｒ＂： ｛
＂ｍｅｓｓａｇｅ＂： ＂ｐｒｉｖａｔｅＩｐ ［％ｓ］ ｉｓ ｎｏｔ ｉｎ ｔｈｉｓ ｓｕｂｎｅｔ ［％ｓ］＂，
＂ｃｏｄｅ＂： ＂Ｅｃｓ．０００５＂，
＂ｄｅｔａｉｌｓ＂： ［
｛
＂ｃｏｄｅ＂： ＂Ｅｃｓ．００３９＂
｝
］
｝
｝
返回值
请参考通用请求返回值。
错误码
请参考错误码。
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱）[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]
