CreateInstances_轻量应用服务器_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 在调用该接口前,建议您了解轻量应用服务器的计费信息。更多信息,请参见计费项
说明 如果您的阿里云账号有优惠券,则默认会优先使用优惠券支付购买轻量应用服务器实例的费用。
  • 同一个阿里云账号在同一个地域下,购买轻量应用服务器与轻量应用负载均衡、轻量容器服务、轻量数据库服务的总数量上限为 50 台。

  • 调用该接口创建服务器时,您需要确保您的阿里云账户余额充足,否则会创建失败。

流控信息

请求速率为50/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
swas-open:CreateInstances
Create
Instance
acs:swas-open:{#regionId}:{#accountId}:instance/*

请求参数

字段名称字段详情
RegionIdstring

地域 ID。您可以调用 ListRegions 查询可用地域。

示例值:cn-hangzhou 参考取值来源:
    ListRegions
ImageIdstring

镜像 ID。您可以调用 ListImages 查询指定地域下可用的镜像 ID。

示例值:e2c9c365024a44369c9b955a998a****参考取值来源:
    ListImages
    CreateCustomImage
PlanIdstring

套餐 ID。您可以调用 ListPlans 查询指定地域下的全部套餐信息。

示例值:swas.s1.c1m1s40b3t05参考取值来源:
    ListPlans
Periodinteger<int32>

购买资源的时长。单位:月。取值范围:{"1", "3", "6", "12", "24", "36"}

示例值:1取值 <= 36
AutoRenewboolean

是否开启到期自动续费。取值范围:展开详情

示例值:false
AutoRenewPeriodinteger<int32>

自动续费的时长,仅当AutoRenew=true时该参数必填。单位:月。取值范围:{"1", "3", "6", "12", "24", "36"}

示例值:3取值 <= 36
DataDiskSizeinteger<int64>

挂载的数据盘容量大小。单位:GB。取值范围:0~16380,取值必须是 20 的整数倍。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:20取值 <= 16380
Amountinteger<int32>

创建轻量应用服务器的数量。取值范围:1~20展开详情

示例值:1取值 <= 200
ChargeTypestring

计费方式。取值:PrePaid,目前仅支持包年包月计费方式。展开详情

示例值:PrePaid
ClientTokenstring

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

示例值:123e4567-e89b-12d3-a456-426655440000

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:30637AD6-D977-4833-A54C-CC89483E1FEE
InstanceIdsarray<string>

轻量应用服务器的实例 ID。

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
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.诊断
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.诊断
404
InvalidPlanId.NotFound
The specified PlanId does not exist.诊断
500
InternalError
An error occurred while processing your request.诊断
500
NotEnoughUpgradeStock
The upgrade stock is insufficient.诊断

变更历史

变更时间变更内容概要操作
2021-08-13
变更错误码400

相关示例