云服务器 ECS：CreateInstance - 创建实例

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

镜像文件 ID，启动实例时选择的镜像资源。如需使用云市场镜像，您可以在云市场镜像商详情页查看ImageId。当您不通过指定ImageFamily选用镜像族系最新可用镜像时，此参数必选。

镜像族系名称，通过设置该参数来获取当前镜像族系内最新可用镜像来创建实例。

• 设置了ImageId，则不能设置该参数。
• 未设置ImageId，则可以设置该参数。

实例的资源规格。

• 产品选型：参见实例规格族或调用 DescribeInstanceTypes 查看目标实例规格的性能数据，或者参见选型配置了解如何选择实例规格。
• 查询库存：调用 DescribeAvailableResource 查看指定地域或者可用区内的资源供给情况。

指定新创建实例所属于的安全组 ID。

实例的名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文等）和数字。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。如果没有指定该参数，默认值为实例 ID。

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

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

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

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

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

PeriodUnit 为 Month 时，AutoRenewPeriod 取值：1、2、3、6、12。

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

• 当所购出网带宽小于等于 10 Mbit/s 时：1~10。默认值为 10。
• 当所购出网带宽大于 10 Mbit/s 时：1~InternetMaxBandwidthOut的取值，默认为InternetMaxBandwidthOut的取值。

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

默认值为 0。

云服务器的主机名。

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

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

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

您需要注意：

• 如果传入 Password 参数，建议您使用 HTTPS 协议发送请求，避免密码泄露。
• Windows 实例不能以正斜线（/）为密码首字符。
• 部分操作系统的实例不支持配置密码，仅支持配置密钥对。例如：Others Linux、Fedora CoreOS。

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

部署集 ID。

如果您设置的部署集对应的策略为部署集组高可用策略（AvailabilityGroup）时，可以通过该参数指定实例在部署集中的分组号。取值范围为 1~7。

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

默认值：空，系统自动选择。

实例所在的集群 ID。

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

虚拟局域网 ID。

实例的内网 IP。

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

• 普通云盘：20~500

• 其他类型云盘：20~2048

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

默认值：max{40, ImageSize} 。

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

• cloud_efficiency：高效云盘。
• cloud_ssd：SSD 云盘。
• cloud_essd：ESSD 云盘。
• cloud：普通云盘。
• cloud_auto：ESSD AutoPL 云盘。
• cloud_essd_entry：ESSD Entry 云盘。

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

系统盘名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文和数字等）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。

默认值为空。

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

默认值为空。

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

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

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

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

默认值为空。

如果是创建 VPC 类型的实例，需要指定交换机 ID。您可以调用 DescribeVSwitches 查询已创建的交换机的相关信息。

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

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

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

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

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

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

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

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

购买资源的时长，单位由PeriodUnit指定。当参数InstanceChargeType取值为PrePaid时才生效且为必选值。一旦指定了DedicatedHostId，则取值范围不能超过专有宿主机的订阅时长。取值范围：

PeriodUnit=Month 时，Period 取值：1、2、3、6、12。

购买资源的时长。取值范围：

Month。

默认值为 Month。

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

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

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

密钥对名称。

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

抢占式实例的保留时长，单位为小时。默认值：1。取值范围：

• 1：创建后阿里云会保证实例运行 1 小时不会被自动释放；超过 1 小时后，系统会自动比较出价与市场价格、检查资源库存，来决定实例的持有和回收。
• 0：创建后，阿里云不保证实例运行 1 小时，系统会自动比较出价与市场价格、检查资源库存，来决定实例的持有和回收。

实例回收前 5 分钟阿里云会通过 ECS 系统事件向您发送通知。抢占式实例按秒计费，建议您结合具体任务执行耗时来选择合适的保留时长。

抢占实例中断模式。取值范围：

• Terminate：直接释放实例。

• Stop：实例进入节省停机模式。

  关于节省停机模式的更多说明，请参见按量付费实例节省停机模式。

默认值：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（默认）：关闭实例释放保护。

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

• default：实例不与专有宿主机关联。已启用节省停机模式的实例，停机后再次启动时，若原专有宿主机可用资源不足，则实例被放置在自动部署资源池的其它专有宿主机上。

• host：实例与专有宿主机关联。已启用节省停机模式的实例，停机后再次启动时，仍放置在原专有宿主机上。若原专有宿主机可用资源不足，则实例重启失败。

默认值为 default。

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

• default：在非专有宿主机上创建实例。

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

默认值为 default。

存储集 ID。

存储集中的最大分区数量。取值范围：大于等于 2。

是否启用实例元数据的访问通道。取值范围：

• enabled：启用。
• disabled：禁用。

默认值为 enabled。

访问实例元数据时是否强制使用加固模式（IMDSv2）。取值范围：

• optional：不强制使用。
• required：强制使用。设置该取值后，普通模式无法访问实例元数据。

默认值为 optional。

实例启动的私有池容量选项。弹性保障服务或容量预定服务在生效后会生成私有池容量，供实例启动时选择。取值范围：

• Open：开放模式。将自动匹配开放类型的私有池容量。如果没有符合条件的私有池容量，则使用公共池资源启动。该模式下无需设置PrivatePoolOptions.Id参数。
• Target：指定模式。使用指定的私有池容量启动实例，如果该私有池容量不可用，则实例会启动失败。该模式下必须指定私有池 ID，即PrivatePoolOptions.Id参数为必填项。
• None：不使用模式。实例启动将不使用私有池容量。

默认值为 None。

以下任一场景，实例启动的私有池容量选项只能取值None或不传值。

• 创建抢占式实例。
• 创建经典网络类型的 ECS 实例。
• 在专有宿主机 DDH 上创建 ECS 实例。

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID。

数据盘列表。

标签列表。

系统盘相关参数，目前专属块存储集群 ID（StorageClusterId）需要通过该参数设置参数值。