RunInstances_云服务器 ECS_API调试

请确保在使用该接口前，已充分了解 ECS 产品的收费方式和价格。

本接口为异步接口，当前创建实例请求发送成功后会返回实例 ID，实例的创建和启动不是立即完成的，需要调用 DescribeInstanceStatus 查看实例信息，当返回信息中的状态为Running时代表创建并启动成功。

使用须知

• 请确保您的账号已通过实名认证。更多信息，请参见账号实名认证相关文档。

• 请确保您创建的实例总数或者全实例规格 vCPU 不会超出系统配额。更多信息，请参见配额中心。

• 创建专有网络 VPC 类型实例前，请预先在相应的阿里云地域创建 VPC。

注意事项

• 若实例计费方式为包年包月（PrePaid），在付款时默认会使用您可用的优惠券。
• 单次最多能创建 100 台实例，超出 100 台，建议您分批或并发调用。
• 如果参数InternetMaxBandwidthOut的值大于 0，则自动为实例分配公网 IP。

使用建议

• 测试场景：可以通过设置DryRun=true发送预检请求。
• 释放实例：您可以通过参数AutoReleaseTime设置实例自动释放时间，或者调用 DeleteInstances 进行手动释放。
• 管理与检索：建议您为每批次启动的实例指定标签（Tag.N.Key和Tag.N.Value），并且为主机名（HostName）和实例名称（InstanceName）添加有序后缀（UniqueSuffix）。具体操作，请参见批量设置有序的实例名称或主机名称。
• 启动模板：利用实例启动模板能为您免除每次创建实例时都需要填入大量配置参数的麻烦，您可以通过 CreateLaunchTemplate 创建实例启动模板后，在RunInstances请求中指定LaunchTemplateId和LaunchTemplateVersion使用启动模板。
• 关闭超线程：在内存密集型业务场景，可以通过设置CpuOptions.ThreadsPerCore=1关闭超线程来提高内存配比。
• 开启巨型帧：可以指定 NetworkOptions.EnableJumboFrame=true在创建时开启Jumbo frame特性。 更多信息，请参见 ECS 实例 MTU。

请求示例

假设您需要在华东 1（杭州）地域创建一些 ECS 实例。期望使用特定的镜像、实例规格、安全组和虚拟交换机，同时配置一定容量的系统盘和数据盘，并分配公网 IP 和设定实例名称与密码。相关配置请求参数如下：

RegionId:"cn-hangzhou", //设置华东 1（杭州）地域
ImageId:"aliyun_3_x64_20G_alibase_20221102.vhd", //设置镜像 ID
InstanceType:"ecs.g7.large", //设置实例规格
SecurityGroupId:"sg-bp150uqocpf9jj70****", //设置安全组 ID
VSwitchId:"vsw-bp1qo7s91cbch5i4l****", //设置虚拟交换机 ID
SystemDisk:{
  Category:"cloud_essd", //设置系统盘类别为 ESSD 云盘
  Size:40, //设置系统盘大小为 40GiB
},
DataDisk:[
  {
    Category:"cloud_essd", //设置数据盘类别为 ESSD 云盘
    Size:100, //设置数据盘大小为 100GiB
  }
],
HostName:"ECS-test", //设置实例主机名称
Password:"ECS@test1234", //设置实例登录密码
InternetMaxBandwidthOut:10 //设置公网出带宽为 10Mbit/s

在上述配置的基础上，创建不同类型实例：

Amount:5, //创建数量为 5 台
InstanceChargeType:"PrePaid", //表示包年包月
PeriodUnit:"Month", //设置时长单位为"月"
Period:1, //设置时长为 1 个月
AutoRenew:true, //表示自动续费
AutoRenewPeriod:1 //续费时长为 1 个月

Amount:10, //创建数量为 10 台
InstanceChargeType:"PostPaid", //表示按量付费
SpotStrategy:"NoSpot" //默认值，表示正常按量付费

Amount:20, //创建数量为 20 台
InstanceChargeType:"PostPaid",
SpotStrategy:"SpotAsPriceGo", //表示抢占式实例的竞价策略为根据市场价格自动出价
SpotDuration:1 //设置抢占式实例的保留时长为 1 小时

假设您已通过 CreateLaunchTemplate 创建了一个实例启动模版，现在需要使用该模版在华东 1（杭州）地域创建一些 ECS 实例。示例如下：

RegionId:"cn-hangzhou", //设置华东 1（杭州）地域
Amount:10, //创建数量为 10 台
LaunchTemplateId:"lt-bp14xczpoxvb6rre****" //设置实例启动模版 ID