调用CreateInstances创建包年包月轻量应用服务器实例-轻量应用服务器-阿里云

创建一台或多台包年包月的轻量应用服务器实例。

接口说明

在调用该接口前，建议您了解轻量应用服务器的计费信息。更多信息，请参见计费项。

说明

如果您的阿里云账号有优惠券，则默认会优先使用优惠券支付购买轻量应用服务器实例的费用。

同一个阿里云账号在同一个地域下，购买轻量应用服务器与轻量应用负载均衡、轻量容器服务、轻量数据库服务的总数量上限为 50 台。
调用该接口创建服务器时，您需要确保您的阿里云账户余额充足，否则会创建失败。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

swas-open:CreateInstances

create

*Instance

acs:swas-open:{#regionId}:{#accountId}:instance/*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。您可以调用 ListRegions 查询可用地域。	cn-hangzhou
ImageId	string	是	镜像 ID。您可以调用 ListImages 查询指定地域下可用的镜像 ID。	e2c9c365024a44369c9b955a998a****
PlanId	string	是	套餐 ID。您可以调用 ListPlans 查询指定地域下的全部套餐信息。	swas.s1.c1m1s40b3t05
Period	integer	是	购买资源的时长。单位：月。取值范围：{"1", "3", "6", "12", "24", "36"}	1
AutoRenew	boolean	否	是否开启到期自动续费。取值范围： true：开启 false：不开启默认值：false	false
AutoRenewPeriod	integer	否	自动续费的时长，仅当`AutoRenew=true`时该参数必填。单位：月。取值范围：{"1", "3", "6", "12", "24", "36"}	3
DataDiskSize	integer	否	挂载的数据盘容量大小。单位：GB。取值范围：0~16380，取值必须是 20 的整数倍。取值为 0 时，表示不挂载数据盘。如果您选择的套餐使用的是 ESSD 云盘（性能级别 PL0），则挂载的数据盘容量最小值为 40 GB。如果您选择的套餐使用的是 SSD 云盘，则挂载的数据盘容量最小值为 20 GB。默认值：0	20
Amount	integer	否	创建轻量应用服务器的数量。取值范围：1~20 默认值：1	1
ChargeType	string	否	计费方式。取值：PrePaid，目前仅支持包年包月计费方式。默认值：PrePaid	PrePaid
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。	123e4567-e89b-12d3-a456-426655440000

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	30637AD6-D977-4833-A54C-CC89483E1FEE
InstanceIds	array	轻量应用服务器的实例 ID。
	string	轻量应用服务器的实例 ID。	3a658ca270df4df39f22e289b338****

示例

正常返回示例

JSON格式

{
  "RequestId": "30637AD6-D977-4833-A54C-CC89483E1FEE",
  "InstanceIds": [
    "3a658ca270df4df39f22e289b338****"
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	ExceedAccountQuota	The accumulated instance amounts including this order have exceeded the quota of the account.
400	NotEnoughStock	The stock is insufficient.	库存不足。
400	PlatformNotMatch	The platform of specified ImageId and PlanId does not match.	指定的套餐和镜像不匹配。
400	InvalidPeriod.ValueNotSupported	The specified parameter Period is invalid.	指定的时长不合法。
400	InvalidDataDiskSize.ValueNotSupported	The specified parameter DataDiskSize is invalid.	指定的数据盘大小不合法。
400	InvalidAmount.ValueNotSupported	The specified parameter Amount is invalid.	指定的实例数不合法。
400	InvalidChargeType.ValueNotSupported	The specified parameter ChargeType is invalid.	指定的实例计费方式不合法。
400	InvalidAutoRenewPeriod.ValueNotSupported	The specified parameter AutoRenewPeriod is invalid.	指定的续费时长不合法。
400	InvalidPlanIdSize.ValueNotSupported	The system disk size in the specified planId does not support the image.	指定的套餐包含的系统盘大小不支持当前镜像。
400	InvalidPlanMemorySize.ValueNotSupported	The memory size in the specified planId does not support the image.	指定的套餐内存大小不支持当前镜像。
500	InternalError	An error occurred while processing your request.	内部错误，请重试。如果多次尝试失败，请提交工单。
500	NotEnoughUpgradeStock	The upgrade stock is insufficient.	升级库存不足。
403	PaymentFailed	Payment failed. Please check your account balance.	支付失败，请检查您的账户余额是否不足。
403	InvalidInstance.UnPaidOrder	The specified Instance has an unpaid order.	您有未支付订单，请支付该类订单后再重新下单。
403	InvalidParam	The specified parameter value is invalid.	参数非法。
404	InvalidImageId.NotFound	The specified ImageId does not exist.	指定的镜像不存在，请您检查镜像ID是否正确。
404	InvalidPlanId.NotFound	The specified PlanId does not exist.	指定的套餐不存在，请您检查套餐ID是否正确。

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

变更历史

更多信息，参考变更详情。