阿里云服务器CreateInstance

镜像文件ID，启动实例时选择的镜像资源。如需使用云市场镜像，您可以在云市场镜像商详情页查看ImageId。

实例的资源规格。更多详情，请参见实例规格族，也可以调用DescribeInstanceTypes接口获得最新的规格表。

实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

系统规定参数。对于您自行拼凑HTTP/HTTPS URL发起的API请求，Action为必选参数。取值：CreateInstance

指定新创建实例所属于的安全组ID，同一个安全组内的实例之间可以互相访问。

实例的名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。如果没有指定该参数，默认值为实例的InstanceId。

是否要自动续费。当参数InstanceChargeType取值PrePaid时才生效。取值范围：

• true：自动续费。
• false（默认）：不自动续费。

网络计费类型。取值范围：

• PayByBandwidth：按固定带宽计费
• PayByTraffic（默认）：按使用流量计费

每次自动续费的时长，当参数AutoRenew取值True时为必填。

PeriodUnit为Week时，AutoRenewPeriod取值{“1”, “2”, “3”}

PeriodUnit为Month时，AutoRenewPeriod取值{“1”, “2”, “3”, “6”, “12”}

公网入带宽最大值，单位为Mbit/s。取值范围：1~200

默认值：200

公网出带宽最大值，单位为Mbit/s。取值范围：0~100

默认值：0

云服务器的主机名。

• 点号（.）和短横线（-）不能作为首尾字符，更不能连续使用。
• Windows实例：字符长度为2~15，不支持点号（.），不能全是数字。允许大小写英文字母、数字和短横线（-）。
• 其他类型实例（Linux等）：字符长度为2~64，支持多个点号（.），点之间为一段，每段允许大小写英文字母、数字和短横线（-）。

实例的密码。长度为8至30个字符，必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是：

()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

其中，Windows实例不能以斜线号（/）为密码首字符。

说明 如果传入Password参数，建议您使用HTTPS协议发送请求，避免密码泄露。

是否使用镜像预设的密码。使用该参数时，Password参数必须为空，同时您需要确保使用的镜像已经设置了密码。

部署集ID。

实例所属的可用区ID。更多详情，请参见DescribeZones获取可用区列表。

默认值：空，表示随机选择。

实例所在的集群ID。

说明 该参数即将被弃用，为提高兼容性，请尽量使用其他参数。

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见如何保证幂等性。

实例的VLAN ID。

实例的内网IP。

系统盘大小，单位为GiB。取值范围：20~500

该参数的取值必须大于或者等于max{20, ImageSize}。

默认值：max{40, ImageSize}

系统盘的云盘种类。取值范围：

• cloud_efficiency：高效云盘
• cloud_ssd：SSD云盘
• cloud：普通云盘

已停售的实例规格且非I/O优化实例默认值为cloud，否则默认值为cloud_efficiency。

系统盘名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。

默认值：空。

系统盘描述。长度为2~256个英文或中文字符，不能以http://和https://开头。

默认值：空。

第n个数据盘的容量大小，n的取值范围为1~16，内存单位为GiB。取值范围：

• cloud_efficiency：20~32768
• cloud_ssd：20~32768
• cloud_essd：20~32768
• ephemeral_ssd：5~800
• cloud：5~2000

该参数的取值必须大于等于参数SnapshotId指定的快照的大小。

创建数据盘n使用的快照。N的取值范围为1~16。

• 指定参数DataDisk.N.SnapshotId后，参数DataDisk.N.Size会被忽略，实际创建的云盘大小为指定的快照的大小。
• 不能使用早于2013年7月15日（含）创建的快照，请求会报错被拒绝。

数据盘N的云盘种类。取值范围：

• cloud_efficiency：高效云盘
• cloud_ssd：SSD云盘
• ephemeral_ssd：本地SSD盘
• cloud_essd：ESSD云盘
• cloud：普通云盘

I/O优化实例的默认值为cloud_efficiency，非I/O优化实例的默认值为cloud。

数据盘名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。

默认值：空。

数据盘描述。长度为2~256个英文或中文字符，不能以http://和https://开头。

默认值：空。

挂载点。

说明 该参数即将停止使用，为提高代码兼容性，建议您尽量不要使用该参数。

数据盘是否随实例释放。

默认值：true。

数据盘N是否加密。

默认值：false。

实例的描述。长度为2~256个英文或中文字符，不能以http://和https://开头。

默认值：空。

如果是创建VPC类型的实例，需要指定虚拟交换机ID。

实例私网IP地址。该IP地址必须为虚拟交换机（VSwitchId）网段的空闲地址。

是否为I/O优化实例。取值范围：

• none：非I/O优化
• optimized：I/O优化

已停售的实例规格实例默认值是none。

其他实例规格默认值是optimized。

是否使用阿里云提供的虚拟机系统配置（Windows：NTP、KMS；Linux：NTP、YUM）。

实例的付费方式。取值范围：

• PrePaid：包年包月。选择该类付费方式时，您必须确认自己的账号支持余额支付/信用支付，否则将返回 InvalidPayMethod的错误提示。
• PostPaid（默认）：按量付费。

购买资源的时长，单位为：月。取值范围：

PeriodUnit为Week时，Period取值：{“1”, “2”, “3”, “4”}

PeriodUnit为Month时，Period取值：{ “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “12”, “24”,
“36”,”48”,”60”}

• 当参数InstanceChargeType取值为PrePaid时才生效且为必选值。
• 一旦指定了DedicatedHostId，则取值不能超过专有宿主机的订阅时长。

购买资源的时长。

取值范围：Week和Month（默认）。

实例、云盘和主网卡的标签键。N的取值范围：1~20。一旦传入该值，则不允许为空字符串。最多支持128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

实例、云盘和主网卡的标签值。N的取值范围：1~20。一旦传入该值，可以为空字符串。最多支持128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

实例自定义数据，需要以Base64方式编码，原始数据最多为16KB。

后付费实例的抢占策略。当参数InstanceChargeType取值为PostPaid时生效。取值范围：

• NoSpot（默认）：正常按量付费实例。
• SpotWithPriceLimit：设置上限价格的抢占式实例。
• SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。

密钥对名称。

• Windows实例，忽略该参数。默认为空。即使填写了该参数，仍旧只执行Password的内容。
• Linux实例的密码登录方式会被初始化成禁止。为提高实例安全性，强烈建议您使用密钥对的连接方式。

设置实例的每小时最高价格。支持最大3位小数，参数SpotStrategy取值为SpotWithPriceLimit时生效。

抢占实例中断模式。目前仅支持Terminate（默认）直接释放实例。

实例RAM角色名称。您可以使用RAM API ListRoles查询您已创建的实例RAM角色。

是否开启安全加固。取值范围：

• Active：启用安全加固，只对系统镜像生效。
• Deactive：不启用安全加固，对所有镜像类型生效。

实例所在的企业资源组ID。

实例所属的HPC集群ID。

是否只预检此次请求。取值范围：

• true：发送检查请求，不会创建实例。检查项包括是否填写了必需参数、请求格式、业务限制和ECS库存。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码DryRunOperation。
• false（默认）：发送正常请求，通过检查后直接创建实例。

是否在专有宿主机上创建ECS实例。

您可以通过DescribeDedicatedHosts查询专有宿主机ID列表。

由于专有宿主机不支持创建抢占式实例，指定DedicatedHostId参数后，会自动忽略请求中的SpotStrategy和SpotPriceLimit设置。

修改突发性能实例的运行模式。取值范围：

• Standard：标准模式，实例性能请参见什么是突发性能实例下的性能约束模式章节。
• Unlimited：无性能约束模式，实例性能请参见什么是突发性能实例下的无性能约束模式章节。

默认值：无。

实例释放保护属性，指定是否支持通过控制台或API（DeleteInstance）释放实例。

• true：开启实例释放保护。
• false（默认）：关闭实例释放保护。

说明 该属性仅适用于按量付费实例，且只能限制手动释放操作，对系统释放操作不生效。

创建ESSD云盘作为系统盘使用时，设置云盘的性能等级。取值范围：

• PL1（默认）：单盘最高随机读写IOPS 5万。
• PL2：单盘最高随机读写IOPS 10万。
• PL3：单盘最高随机读写IOPS 100万。

有关如何选择ESSD性能等级，请参见ESSD云盘。

创建ESSD云盘作为数据盘使用时，设置云盘的性能等级。N的取值必须和DataDisk.N.Category=cloud_essd中的N保持一致。取值范围：

• PL1（默认）：单盘最高随机读写IOPS 5万。
• PL2：单盘最高随机读写IOPS 10万。
• PL3：单盘最高随机读写IOPS 100万。

有关如何选择ESSD性能等级，请参见ESSD云盘。

云盘使用的KMS密钥ID。

专有宿主机实例是否与专有宿主机关联。取值范围：

• default：实例不与专有宿主机关联。已开启停机不收费功能的实例，停机后再次启动时，若原专有宿主机可用资源不足，则实例被放置在自动部署资源池的其它专有宿主机上。
• host：实例与专有宿主机关联。已开启停机不收费功能的实例，停机后再次启动时，仍放置在原专有宿主机上。若原专有宿主机可用资源不足，则实例重启失败。

默认值：default。

是否在专有宿主机上创建实例。取值范围：

• default：在非专有宿主机上创建实例。
• host：在专有宿主机上创建实例。若您不指定DedicatedHostId，则由阿里云自动选择专有宿主机部署实例。

默认值：default。