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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	RunInstances	系统规定参数。取值：RunInstances。
InstanceType	String	是	ens.sn1.small	实例规格。
InstanceChargeType	String	是	PostPaid	实例付费方式。取值： PrePaid：预付费，包年包月。 PostPaid：按量付费。
ImageId	String	否	m-5si16wo6simkt267p8b7h****	镜像ID。arm版卡不能填，其他类型规格必填。
NetDistrictCode	String	否	350000	地区Code。说明区域级调度时必填，节点级调度时无效。
Carrier	String	否	telecom	运营商。说明区域级调度时必填，节点级调度时无效。
ScheduleAreaLevel	String	是	Region	调度层级。通过该字段来执行节点级调度或者区域调度。取值： Big：大区 Middle：省份 Small：城市 Region：节点
SchedulingStrategy	String	否	Concentrate	调度策略。取值： Concentrate：集中 Disperse：分散说明节点级调度时，为Concentrate；区域级调度时，按客户需求选择。
EnsRegionId	String	否	cn-foshan-telecom	节点ID。说明节点级调度时必填，区域级调度时无效。
Password	String	否	testPassword	实例密码。说明 Password、KeyPairName、PasswordInherit至少填入一个。
KeyPairName	String	否	wx2-jumpserver	密钥对名称。说明 Password、KeyPairName、PasswordInherit至少填入一个。
InternetChargeType	String	否	BandwidthByDay	带宽计费方式。取值： BandwidthByDay：日峰值带宽 95BandwidthByMonth：月95峰值带宽说明如果是第一次新购时可以进行选择计费方式，后续此字段值会根据第一次所选择的计费方式进行默认处理。
SystemDisk	Object	否		系统盘规格。
Size	Long	否	50	系统盘大小，单位：GiB。
Category	String	否	local_ssd	系统盘类型。
DataDisk	Array	否		数据盘规格。
Size	Long	否	20	数据盘大小，单位：GiB。
Category	String	否	cloud_efficiency	磁盘种类。取值： cloud_efficiency：高效云盘 cloud_ssd：全闪云盘 local_hdd：本地HDD盘 local_ssd：本地SSD盘
Period	Long	否	1-9，12	购买资源的时长。如果PeriodUnit取值为Day时，则Period仅可设置为3。如果PeriodUnit取值为Month时，则Period可设置为1-9,12。
InternetMaxBandwidthOut	Long	是	1	公网最大带宽，如果本参数的值大于0，则自动为实例分配公网IP。
Amount	Long	是	1	创建的实例数量。取值范围：1~100。
NetWorkId	String	否	net-id	网络ID。说明只能在节点级调度使用，区域级调度时配置该参数会报错。
VSwitchId	String	否	vsw-5sagnw7m613oulalkd10n****	交换机ID。说明只能在节点级调度使用，区域级调度时配置该参数会报错。
SecurityId	String	否	sg-test	安全组ID。
HostName	String	否	test-HostName	主机名称。
InstanceName	String	否	TestName	实例名称。长度为2~128个字符，必须以大小字母或中文开头，不能以`http://`和`https://`开头。可以包含中文、英文、数字、半角冒号（:）、下划线（_）、点号（.）或者连字符（-）。默认值为实例的InstanceId。
UniqueSuffix	Boolean	否	True	是否为HostName和InstanceName添加有序后缀，有序后缀从001开始递增，最大不能超过999。
UserData	String	否	ZWtest	用户自定义数据，最大支持16 KB。您可传入UserData信息，UserData以Base64的方式编码。
AutoRenew	Boolean	否	true	是否自动续费。取值： true：自动续费 false：不自动续费（默认）说明按量付费时，该参数无效。
SchedulingPriceStrategy	String	否	PriceHighPriority	调度价格策略。取值： PriceHighPriority：优先高价 PriceLowPriority：优先低价
PrivateIpAddress	String	否	10.0.XX.XX	私网IP地址。说明只能在节点级调度使用，区域级调度时配置该参数会报错。如果指定了私网IP，实例数量只能为1台，且私网IP和交换机ID同时非空时，该私网IP才生效。
PeriodUnit	String	否	Month	购买资源的时长单位。取值： Month（默认）：按月购买。 Day：按天购买。
PublicIpIdentification	Boolean	否	true	是否启用公网ipidentification。取值：-true：启用。-false（默认值）：不启用。
PasswordInherit	Boolean	否	false	是否使用镜像预置密码。取值： true：使用 false：不使用说明 Password、KeyPairName、PasswordInherit至少填入一个。
InstanceChargeStrategy	String	否	instance	实例计费策略。取值： instance：实例粒度不传默认按用户维度
BillingCycle	String	否	Day	实例计算资源计费周期，仅支持实例级后付费。取值 Hour：按小时计费。 Day：按天计费。 Month：按月计费。

返回数据

名称	类型	示例值	描述
RequestId	String	91E4AFBE-4E35-5D2A-A886-BB477C9953D2	请求ID。
InstanceIds	Array of String	['i-5xxxx26dix05koz15l5413j25o', 'i-5sdmxxxx']	实例ID列表。
OrderId	String	213177957850399	订单编号。

示例

请求示例

http(s)://ens.aliyuncs.com/?Action=RunInstances
&InstanceType=ens.sn1.small
&InstanceChargeType=PostPaid
&ImageId=m-5si16wo6simkt267p8b7h****
&NetDistrictCode=350000
&Carrier=telecom
&ScheduleAreaLevel=Region
&SchedulingStrategy=Concentrate
&EnsRegionId=cn-foshan-telecom
&Password=testPassword
&KeyPairName=wx2-jumpserver
&InternetChargeType=BandwidthByDay
&SystemDisk={"Size":50}
&DataDisk=[{"Size":20,"Category":"cloud_efficiency"}]
&InternetMaxBandwidthOut=1
&Amount=1
&NetWorkId=net-id
&VSwitchId=vsw-5sagnw7m613oulalkd10n****
&SecurityId=sg-test
&HostName=test-HostName
&InstanceName=TestName
&UniqueSuffix=true
&UserData=ZWtest
&AutoRenew=true
&SchedulingPriceStrategy=PriceHighPriority
&PrivateIpAddress=10.0.XX.XX
&PeriodUnit=Month
&PublicIpIdentification=true
&PasswordInherit=false
&InstanceChargeStrategy=instance
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RunInstancesResponse>
    <RequestId>91E4AFBE-4E35-5D2A-A886-BB477C9953D2</RequestId>
    <InstanceIds>['i-5xxxx26dix05koz15l5413j25o', 'i-5sdmxxxx']</InstanceIds>
    <OrderId>213177957850399</OrderId>
</RunInstancesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode	错误码	错误信息	描述
400	Invalid%s	The specified parameter %s is invalid.	参数不正确
400	Missing%s	You must specify the parameter %s.	参数为必填
400	NoPermission	Permission denied.	没有足够的权限，请联系云账号管理员授予您相应权限。

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