文档

RunInstances - 批量创建实例

调用RunInstances创建一台或多台按量付费或者包年包月ENS实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceTypestring

实例规格。

ens.sn1.small
InstanceChargeTypestring

实例付费方式。取值:

  • PrePaid:预付费,包年包月。
  • PostPaid:按量付费。
PostPaid
ImageIdstring

镜像 ID。arm 版卡不能填,其他类型规格必填。

m-5si16wo6simkt267p8b7h****
NetDistrictCodestring

地区 Code。

说明 区域级调度时必填,节点级调度时无效。
350000
Carrierstring

运营商。

说明 区域级调度时必填,节点级调度时无效。
telecom
ScheduleAreaLevelstring

调度层级。通过该字段来执行节点级调度或者区域调度。取值:

  • Big:大区
  • Middle:省份
  • Small:城市
  • Region:节点
Region
SchedulingStrategystring

调度策略。取值:

  • Concentrate:集中
  • Disperse:分散
说明 节点级调度时,为 Concentrate;区域级调度时,按客户需求选择。
Concentrate
EnsRegionIdstring

节点 ID。

说明 节点级调度时必填,区域级调度时无效。
cn-foshan-telecom
Passwordstring

实例密码。

说明 PasswordKeyPairNamePasswordInherit 至少填入一个。
testPassword
KeyPairNamestring

密钥对名称。

说明 PasswordKeyPairNamePasswordInherit 至少填入一个。
wx2-jumpserver
InternetChargeTypestring

带宽计费方式。取值:

  • BandwidthByDay:日峰值带宽
  • 95BandwidthByMonth:月 95 峰值带宽
说明 如果是第一次新购时可以进行选择计费方式,后续此字段值会根据第一次所选择的计费方式进行默认处理。
BandwidthByDay
SystemDiskobject

系统盘规格。

Sizelong

系统盘大小,单位:GiB。

50
Categorystring

系统盘类型。

local_ssd
DataDiskobject []

数据盘规格。

Sizelong

数据盘大小,单位:GiB。

20
Categorystring

磁盘种类。取值:

  • cloud_efficiency:高效云盘
  • cloud_ssd:全闪云盘
  • local_hdd:本地 HDD 盘
  • local_ssd:本地 SSD 盘
cloud_efficiency
Encryptedboolean

是否加密云盘。取值范围:

  • true:是

  • false(默认值):否

false
KMSKeyIdstring

云盘使用的 KMS 密钥 ID。取值范围:

  • true:是

  • false(默认值):否

说明 如果 Encrypted 置为 true,KMSKeyId 为空时则使用服务默认密钥。
false
Periodlong

购买资源的时长。

  • 如果 PeriodUnit 取值为 Day 时,则 Period 仅可设置为 3

  • 如果 PeriodUnit 取值为 Month 时,则 Period 可设置为1-9,12

1-9,12
InternetMaxBandwidthOutlong

公网最大带宽,如果本参数的值大于 0,则自动为实例分配公网 IP。

1
Amountlong

创建的实例数量。取值范围:1~100。

1
NetWorkIdstring

网络 ID。

说明 只能在节点级调度使用,区域级调度时配置该参数会报错。
net-id
VSwitchIdstring

交换机 ID。

说明 只能在节点级调度使用,区域级调度时配置该参数会报错。
vsw-5sagnw7m613oulalkd10n****
SecurityIdstring

安全组 ID。

sg-test
HostNamestring

主机名称。

test-HostName
InstanceNamestring

实例名称。长度为 2~128 个字符,必须以大小字母或中文开头,不能以http://https://开头。可以包含中文、英文、数字、半角冒号(:)、下划线(_)、点号(.)或者连字符(-)。

默认值为实例的 InstanceId。

TestName
UniqueSuffixboolean

是否为 HostNameInstanceName 添加有序后缀,有序后缀从 001 开始递增,最大不能超过 999。

True
UserDatastring

用户自定义数据,最大支持 16 KB。您可传入 UserData 信息,UserData 以 Base64 的方式编码。

ZWtest
AutoRenewboolean

是否自动续费。取值:

  • true:自动续费
  • false:不自动续费(默认)
说明 按量付费时,该参数无效。
true
SchedulingPriceStrategystring

调度价格策略。取值:

  • PriceHighPriority:优先高价
  • PriceLowPriority:优先低价
PriceHighPriority
PrivateIpAddressstring

私网 IP 地址。

说明 只能在节点级调度使用,区域级调度时配置该参数会报错。 如果指定了私网 IP,实例数量只能为 1 台,且私网 IP 和交换机 ID 同时非空时,该私网 IP 才生效。
10.0.XX.XX
PeriodUnitstring

购买资源的时长单位。取值:

  • Month(默认):按月购买。
  • Day:按天购买。
Month
PublicIpIdentificationboolean

是否启用公网 ipidentification。取值:-true:启用。-false(默认值):不启用。

true
PasswordInheritboolean

是否使用镜像预置密码。取值:

  • true:使用
  • false:不使用
说明 PasswordKeyPairNamePasswordInherit 至少填入一个。
false
InstanceChargeStrategystring

实例计费策略。取值:

  • instance:实例粒度
  • 不传默认按用户维度
instance
BillingCyclestring

实例计算资源计费周期,仅支持实例级后付费。 取值

  • Day:按天计费。

  • Month:按月计费。

Day
IpTypestring

IP 类型。取值:

  • ipv4(默认值):IPv4。

  • ipv6:IPv6。

  • ipv4Andipv6:IPv4 和 IPv6。

ipv4
AutoUseCouponstring

是否使用代金券,默认为使用,即 AutoUseCoupon=true。

true
Tagobject []

实例所绑定的标签

Keystring

自定义标签 key

team
Valuestring

标签值。不可超过 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

tagValue
AutoReleaseTimestring

按量付费实例的自动释放时间。按照ISO 8601标准表示,使用 UTC+0 时间。格式为:yyyy-MM-ddTHH:mm:ssZ

  • 如果秒(ss)取值不是00,则自动取为当前分钟(mm)开始时。

  • 最短释放时间为当前时间一小时之后。

2023-06-28T14:38:52Z
SpotStrategystring

按量付费实例的竞价策略。当参数InstanceChargeType取值为PostPaid时生效。取值范围:

  • NoSpot:正常按量付费实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。

默认值:NoSpot。

SpotAsPriceGo

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

91E4AFBE-4E35-5D2A-A886-BB477C9953D2
InstanceIdsarray

实例 ID 列表。

string

实例 ID 列表。

['i-5xxxx26dix05koz15l5413j25o', 'i-5sdmxxxx']
OrderIdstring

订单编号。

213177957850399

示例

正常返回示例

JSON格式

{
  "RequestId": "91E4AFBE-4E35-5D2A-A886-BB477C9953D2",
  "InstanceIds": [
    "['i-5xxxx26dix05koz15l5413j25o', 'i-5sdmxxxx']"
  ],
  "OrderId": "213177957850399"
}

错误码

HTTP status code错误码错误信息描述
400Invalid%sThe specified parameter %s is invalid.参数不正确
400Missing%sYou must specify the parameter %s.参数为必填
400NoPermissionPermission denied.没有足够的权限,请联系云账号管理员授予您相应权限。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-04-09OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:AutoReleaseTime
    新增入参:SpotStrategy
2024-01-25OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:Tag
2023-11-07OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:AutoUseCoupon
2023-10-19OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
2023-10-17OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:IpType
2023-07-27OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
2023-07-27OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:BillingCycle
2023-06-13OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
2023-06-08OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
2023-05-10OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:InstanceChargeStrategy
  • 本页导读 (1)
文档反馈