创建实例
描述
创建实例需要通过实名认证。没有通过实名认证的可以前往 阿里云官网 中的 用户中心>会员信息 中进行实名认证。
根据传入参数创建弹性计算实例。
在创建实例时,必须要选择镜像,用来确定新创建实例的系统盘配置。镜像包含操作系统以及应用软件配置,基于镜像创建实例后,实例的系统盘即为此镜像的完全克隆。
一个实例创建时必须指定加入一个安全组。安全组需要预先创建,可通过 创建安全组 接口创建,可以在新创建实例时指定,也可通过 修改实例属性 的接口来完成实例所属安全组变更。在同一个安全组内的实例内网可以相互访问,但不同安全组之间默认有防火墙隔离,不可相互访问,但可通过安全组授权(通过授权安全组权限接口实现)来设置此安全组的防火墙权限。同一个安全组内的实例数量不能超过 1000 个,若组内实例数量超出限制,创建实例时若指定该安全组,会提示失败。
在创建实例时,如果参数 InternetChargeType 的值设置为 PayByBandwidth(按固定带宽付费),则 InternetMaxBandwidthOut 的设置值即为所选的固定带宽值;如果参数 InternetChargeType 的值设置为 PayByTraffic(按流量付费),则 InternetMaxBandwidthOut 只是一个带宽的上限设置,计费以发生的网络流量为依据。设置 InternetChargeType 和 InternetMaxBandwidthOut 时,应仔细核算可能发生的带宽费用。
创建实例时,可以选择是否为IO优化实例。
InternetMaxBandwidthIn 的值在任何情况下都与计费无关,实例的入数据流量是免费的。
实例创建时,系统会根据用户所指定镜像为实例分配一个相应大小的系统盘,系统盘容量=Max{40,ImageID};也可以指定系统盘的容量SystemDisk.size参数,该参数必须大于等于max{40,ImageID};同时,可以指定系统盘的种类:普通云盘(cloud)、高效云盘(cloud_efficiency)、SSD云盘(cloud_ssd)、本地 SSD 盘(ephemeral_ssd)。
ECS 不支持单独创建或者添加本地 SSD 盘,因此本地 SSD 盘必须在创建实例时指定,实例创建完成后不能再添加。各个实例规格对不同磁盘种类大小的限制见 实例资源规格对照表。
单块普通云盘(cloud)容量最大不能超过2000GB,单块高效云盘(cloud_efficiency)容量最大不超过 32TB(32768 GB),单块SSD云盘(cloud_ssd)容量最大不能超过32TB(32768 GB),单块本地 SSD 盘(ephemeral_ssd)容量最大不能超过 800GB。
随实例创建的系统盘,其Portable属性为false,即不支持卸载和挂载操作。系统盘随实例的释放而释放,所以系统盘的DeleteWithInstance属性为True。
随实例创建的类型为普通云盘(cloud)、高效云盘(cloud_efficiency)或SSD云盘(cloud_ssd)的数据盘,其Portable属性为true,即支持卸载和挂载操作。如果数据盘随实例的释放而释放,则DeleteWithInstance的属性的默认值为True;反之,如果数据盘不随实例的释放而释放,则DeleteWithInstance的属性的默认值为False。
随实例创建的本地 SSD 盘(ephemeral_ssd),其 Portable 属性为 false,即不支持卸载和挂载操作。本地 SSD 盘随实例的释放而释放,所以其 DeleteWithInstance 的属性为 True。
数据盘选择本地 SSD 盘时,系统盘必须为本地 SSD 盘,同时一个实例的本地 SSD 盘总容量不超过 1TB(1024GB,不包括系统盘)
选择了本地 SSD 盘的实例,一旦创建后,不能修改实例规格。
实例内存为 512M 时不能使用 windows 操作系统;内存为 4G 以上时不能使用 32 位操作系统。
当系统盘是普通云盘(cloud)、高效云盘(cloud_efficiency)或SSD云盘(cloud_ssd)时,数据盘不能是ephemeral_ssd。
专有网络类型实例只能在创建时指定,这类实例必须且只能属于一个交换机。
指定 VSwitchId 创建实例时,SecurityGroupId 和 VSwitchId 要属于同一个专有网络。
VSwitchId 和 PrivateIpAddress 同时指定时,PrivateIpAddress 要包含在交换机的 CidrBlock 之内。
PrivateIpAddress 依赖于 VSwitchId,不能单独指定 PrivateIpAddress。
创建完成后,实例为 Stopped 状态。
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
操作接口名,系统规定参数,取值:CreateInstance
RegionId
String
是
实例所属的 Region ID
ZoneId
String
否
实例所属的可用区编号,空表示由系统选择,默认值:空。
ImageId
String
是
镜像文件 ID,表示启动实例时选择的镜像资源
InstanceType
String
是
实例的资源规则。取值参见附表实例资源规格对照表,也可以调用查询实例资源规格列表接口获得最新的规格表。
SecurityGroupId
String
是
指定新创建实例所属于的安全组代码,同一个安全组内的实例之间可以互相访问。
InstanceName
String
否
实例的显示名称,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,“.”,“_”或“-”。 实例名称会显示在控制台。 如果没有指定该参数,默认值为实例的 InstanceId 不能以 // 和 https:// 开头。
Description
String
否
实例的描述,[2, 256] 个字符,实例描述会显示在控制台。不填则为空,默认为空。不能以 // 和 https:// 开头。
InternetChargeType
String
否
网络计费类型,按流量计费还是按固定带宽计费。
可选值:
- PayByBandwidth
- PayByTraffic
如用户不指定,默认是 PayByBandwidth。
InternetMaxBandwidthIn
String
否
公网入带宽最大值,单位为 Mbps(Mega bit per second),取值范围:[1, 200]
如果客户不指定,Aliyun API 将自动将入带宽设置成 200Mbps。
InternetMaxBandwidthOut
String
否
公网出带宽最大值,单位为 Mbps(Mega bit per second),取值范围:
按带宽计费:[0, 100]。如果客户不指定,API 将自动将出带宽设置成 0Mbps。
按流量计费:[1, 100]。如果客户不指定,会报错。
如果需要可以通过阿里云工单系统申请将带宽范围设置成 1 ~ 200Mbps。
HostName
String
否
表示云服务器的主机名,最少 2 字符,“.”和“-”是不能作为 hostname 的首尾字符,不能连续使用。 Windows 平台最长为 15 字符,允许字母(不限制大小写)、数字和“-”组成,不支持点号(”.”),不能全是数字。
其他(Linux 等)平台最长为 30 字符,允许支持多个点号,点之间为一段,每段允许字母(不限制大小写)、数字和“-”组成。
Password
String
否
实例的密码。8-30个字符,必须同时包含三项(大、小写字母,数字和特殊符号)。支持以下特殊字符:( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /
如果传入 Password 参数,请务必使用 HTTPS 协议调用 API 以避免可能发生的密码泄露。
IoOptimized
String
否
IO优化
可选值:
- none:非IO优化
- optimized:IO优化
默认值:none
SystemDisk.Category
String
否
系统盘的磁盘种类
可选值:
- cloud – 普通云盘
- cloud_efficiency – 高效云盘
- cloud_ssd – SSD云盘
- ephemeral_ssd - 本地 SSD 盘
默认值:cloud
SystemDisk.Size
Integer
否
系统盘大小,以GB为单位,取值范围为:
- cloud – 40~500
- cloud_efficiency – 40~500
- cloud_ssd – 40~500
- ephemeral_ssd - 40~500
默认值:size=max{40,ImageID}
指定该参数后,size必须大于等于max{40, ImageID}。
SystemDisk.DiskName
String
否
系统盘名称,不填则为空,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”_“或”-“,磁盘名称会展示在控制台。不能以 // 和 https:// 开头。
SystemDisk.Description
String
否
系统盘描述,不填则为空,默认值为空,[2, 256] 个字符,实例描述会显示在控制台。不填则为空,默认为空。不能以 // 和 https:// 开头。
DataDisk.n.Size
Integer
否
数据盘 n 的磁盘大小(n 从 1 开始编号)。 以 GB 为单位,取值范围为:
- cloud:5 ~ 2000
- cloud_efficiency:20 ~ 32768
- cloud_ssd:20 ~ 32768
- ephemeral_ssd:5 ~ 800
指定该参数后,Size大小必须 ≥ 指定快照SnapshotId的大小。
DataDisk.n.Category
String
否
数据盘 n 的磁盘种类
可选值:
- cloud – 普通云盘
- cloud_efficiency – 高效云盘
- cloud_ssd – SSD云盘
- ephemeral_ssd - 本地 SSD 盘
默认值:cloud
DataDisk.n.SnapshotId
String
否
创建数据盘使用的快照
指定该参数后 DataDisk.n.Size 会被忽略,实际创建的磁盘大小为指定快照的大小。若该快照创建于 2013 年 7 月 15 日(含)之前,该次调用会被拒绝,Response 中返回 InvalidSnapshot.TooOld
DataDisk.n.DiskName
String
否
数据盘名称,不填则为空,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”_“或”-“,磁盘名称会展示在控制台。不能以 // 和 https:// 开头。
DataDisk.n.Description
String
否
数据盘描述,不填则为空,默认值为空,[2, 256] 个字符,磁盘描述会展示在控制台。不能以 // 和 https:// 开头。
DataDisk.n.Device
String
否
空表示由系统默认分配,/dev/xvdb 开始到 /dev/xvdz
默认值:空
DataDisk.n.DeleteWithInstance
String
否
表示数据盘是否随实例释放。
- true 表示实例释放时,这块磁盘随实例一起释放
- false 表示实例释放时,这块磁盘保留不释放
默认值:true
这个参数只对独立普通云盘即 DataDisk.n.Category=cloud,cloud_efficiency和cloud_ssd 时有效,否则会报错。
VSwitchId
String
否
如果是创建 VPC 类型的实例,需要指定交换机的 ID
PrivateIpAddress
否
实例私网 IP 地址,不能单独指定。
ClientToken
String
否
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性。
返回参数
名称 |
类型 |
描述 |
InstanceId
String
实例 ID,由系统生成,全局唯一。是访问实例的唯一标识
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
InvalidRegionId.NotFound
The RegionId provided does not exist in our records.
404
指定的 RegionId 不存在
MissingParameter
The input parameter “RegionId” that is mandatory for processing this request is not supplied.
400
缺少 RegionId 值(实际情况也可能是该用户无权使用此 Region)
InvalidInstanceType.ValueUnauthorized
The specified InstanceType is not authorized.
400
指定的 InstanceType 未授权使用
InvalidSystemDiskSize.LessThanImageSize
The specified parameter“SystemDisk.Size”is less than the image size
404
指定的 SystemDiskSize 小于镜像的大小
InvalidSystemDiskSize.MoreThanMaxSize
The specified parameter “SystemDisk.Size” is more than the max size
404
指定的 SystemDiskSize 大于最大容量上限
InvalidSystemDiskSize.LessThanMinimumSize
The specified parameter”SystemDisk.Size” is less than the minimum size
404
指定的 SystemDiskSize 小于最小容量
InvalidZoneId.NotFound
The ZoneId provided does not exist in our records.
404
指定的 ZoneId 不存在(实际情况也可能是该用户无权使用此 Zone)
MissingParameter
The input parameter “ImageId” that is mandatory for processing this request is not supplied.
400
缺少 ImageId 值
InvalidInstanceType.ValueNotSupported
The specified InstanceType beyond the permitted range.
400
指定的 InstanceType 不合法(超出可选范围)
MissingParameter
The input parameter “InstanceType” that is mandatory for processing this request is not supplied.
400
缺少 InstanceType 值
InvalidSecurityGroupId.NotFound
The SecurityGroupId provided does not exist in our records.
404
指定的 SecurityGroupId 不存在(实际情况也可能是该用户无权使用此 SecurityGroup)
MissingParameter
The input parameter “SecurityGroupId” that is mandatory for processing this request is not supplied.
400
缺少 SecurityGroupId 值
InvalidDescription.Malformed
The specified parameter “Description” is not valid.
400
指定的 Description 格式不合法
InvalidInternetChargeType.ValueNotSupported
The specified InternetChargeType is not valid.
400
指定的 InternetChargeType 不存在
InvalidParameter
The specified parameter “InternetMaxBandwidthIn” is not valid.
400
指定的 InternetMaxBandwidthIn 不合法(不是数字或超出范围)
InvalidParameter
The specified parameter “InternetMaxBandwidthOut” is not valid.
400
指定的 InternetMaxBandwidthOut 不合法(不是数字或超出范围)
InvalidHostName.Malformed
The specified parameter “HostName” is not valid.
400
指定的 HostName 格式不合法
InvalidPassword.Malformed
The specified parameter “Password” is not valid.
400
指定的 Password 格式不合法
InvalidSystemDiskCategory.ValueNotSupported
The specified parameter “SystemDisk.Category” is not valid.
400
指定的 SystemDisk.Category 不合法
InvalidDiskName.Malformed
The specified parameter “SystemDisk.DiskName or DataDisk.n.DiskName” is not valid.
400
指定的 SystemDisk.DiskName 或 DataDisk.n.DiskName 不合法
InvalidDiskDescription.Malformed
The specified parameter “SystemDisk.DiskDescription” or “DataDisk.n.Description” is not valid.
400
指定的 SystemDisk.DiskDescription 或 DataDisk.n.Description 不合法
InvalidParameter
The specified parameter “DataDisk.n.Size” is not valid.
400
指定的 DataDisk.n.Size 不合法(不是数字)
InvalidDataDiskSize.ValueNotSupported
The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category.
400
指定的 DataDisk.n.Size 不合法(超出范围)
InvalidDataDiskCategory.ValueNotSupported
The specified parameter “DataDisk.n.Category” is not valid.
400
指定的 DataDisk.n.Category 不合法
InvalidDataDiskSnapshotId.NotFound
The specified parameter “DataDisk.n.SnapshotId” is not valid.
404
指定的 DataDisk.n.SnapshotId 没找到
InvalidDataDevice.Malformed
The specified parameter “DataDisk.n.Device” is not valid.
400
指定的 DataDisk.n.Device 不合法
OperationDenied
The specified parameter “VlanId” is not valid or vlan has not enough IP address.
400
指定的 VlanId 不合法
InvalidParameter.Conflict
The specified image does not support the specified instance type.
400
指定的 InstanceType 上不允许使用该指定的镜像
InvalidSnapshotId.BasedSnapshotTooOld
The specified snapshot is created before 2013-07-15.
400
使用了 2013-07-15 之前创建的 Snapshot
QuotaExceed.AfterpayInstance
Living afterpay instances quota exceeded.
400
用户的按量付费 Instance 个数达到上限
ImageNotSubscribed
The specified image has not be subscribed.
403
没有订阅镜像市场的镜像
OperationDenied
The specified Image is disabled or is deleted.
403
镜像不可用或者不存在
InvalidSystemDiskCategory.ValueUnauthorized
The disk category is not authorized.
403
磁盘种类未被授权使用
InvalidParameter.Mismatch
The data disk must be cloud disk when system disk category is cloud.
403
系统盘是普通云盘则数据盘必须是普通云盘
InvalidSnapshotId.NotReady
The specified snapshot has not completed yet.
403
快照没有完成
OperationDenied
The specified snapshot is not allowed to create disk.
403
特定磁盘的快照不能创建磁盘或者快照不能创建磁盘
InstanceDiskCategoryLimitExceed
The total size of specified disk category in an instance exceeds.
403
指定的磁盘种类超过了单实例的最大容量
InvalidDevice.InUse
The specified device has been occupied.
403
挂载点已被占用
ImageRemovedInMarket
The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace includeing exact the same product code has been removed.
403
镜像市场的镜像已下架,或者自定义镜像中包含的 product code 对应的镜像市场镜像已经下架
InvalidClusterId.NotFound
The ClusterId provided does not exist in our records.
404
指定的 ClusterId 不存在
OperationDenied
The creation of Instance to the specified Zone is not allowed.
403
该可用区无权创建实例或者 Zone 和 Region 不匹配
CategoryNotSupported
The specified zone does not offer the specified disk category.
403
该可用区无权创建指定种类的磁盘
OperationDenied
The specified Zone or cluster does not offer the specified disk category or the speicified zone and cluster do not match.
403
zone 或者 cluster 不支持该磁盘种类,或者 zone 和 cluster 不匹配
InvalidInstanceName.Malformed
The specified parameter “InstanceName” is not valid.
400
指定的 InstanceName 格式不合法
InvalidInstanceDescription.Malformed
The specified parameter “Description” is not valid.
400
指定的 Instance Description 不合法
OperationDenied
The specified Image is disabled or is deleted.
404
指定的镜像找不到
OperationDenied
The resource is out of usage.
403
zone 或者 Cluster 的库存不够了
InternalError
The request processing has failed due to some unknown error.
500
该用户没有 zone 可用
OperationDenied
The specified region is in resource control, please try later.
403
Region 暂时停售按量实例
InvalidParameter.Conflict
The speicified region and cluster do not match.
400
Region 和 Cluster 不匹配
SecurityGroupInstanceLimitExceed
Exceeding the allowed amount of instances of a security group.
403
该 SecurityGroup 内的 Instance 数量已经达到上限
RegionUnauthorized
There is no authority to create instance in the specified region.
403
用户无权使用该 Region
CategoryNotSupported
The specified Zone or cluster does not offer the specified disk category.
403
zone 或者 cluster 不支持磁盘种类
InvalidSnapshotId.NotDataDiskSnapshot
The specified snapshot is system disk snapshot.
403
系统盘快照不能创建数据盘
OperationDenied
The capacity of snapshot exceeds the size limit of the specified disk category or the specified category is not authorizied.
403
指定的 DataDisk.n.Size 不合法(超出范围)或者磁盘种类未被授权使用
CategoryNotSupported
The specified cluster does not offer the specified disk category.
403
cluster 不支持磁盘种类
InvalidDiskCategory.Mismatch
The specified disk categories’ combination is not supported..
403
所选磁盘类型的组合不支持
QuotaExceed.PortableCloudDisk
The quota of portable cloud disk exceeds.
403
可挂载的普通云盘数量已经达到上限(最多四块)
DeleteWithInstance.Conflict
The specified disk is not a portable disk and cannot be set to DeleteWithInstance attribute.
403
该磁盘不支持挂载与卸载
InstanceDiskNumLimitExceed
The number of specified disk in an instance exceeds.
403
单个 ECS 下挂载的普通云盘数量超过 4 个
IoOptimized.NotSupported
The specified image is not support IoOptimized Instance.
403
镜像必须支持 IO 优化实例
OperationDenied
Another Instance has been creating
403
同步请求,创建 ECS 的数量超过一个
IoOptimized.NotSupported
The specified instancetype is not support IoOptimized instance
403
实例类型不支持 IO 优化实例
InvalidDiskCategory.NotSupported
The specified disk category is not support the specified instance type.
403
所选磁盘种类不能用于所选实例类型
OperationDenied
The specified zone does not support creating instance.
403
所选的可用区不支持创建 IO 优化型实例
InstanceDiskCategoryLimitExceed
The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category.
400
指定的 DataDisk.n.Size 不合法(超出范围)
QuotaExceed.BuyImage
The specified image is from the image market,You have not bought it or your quota has been exceeded.
403
指定的镜像来自镜像市场,您没有购买或者该镜像在次地域的配额已用完
DependencyViolation.Image
The specified imageid is not supported to create iooptimized instance
400
指定的镜像 ID 不支持创建 IO 优化实例
InstanceTypeNotSupported
The specified zone does not offer the specified instancetype.
403
该可用区不支持创建指定的实例规格
DependencyViolation.IoOptimized
The specified instancetype must be IoOptimized instance
404
指定的实例规格必须是 I/O 优化实例
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateInstance&RegionId=cn-hangzhou&ImageId=_32_23c472_20120822172155_aliguest.vhd&SecurityGroupId=sg-c0003e8b9&HostName=Bctest01&InstanceType=ecs.t1.small&<公共请求参数>
返回示例
XML格式
04F0F334-1335-436C-A1D7-6C044FE73368 i-instance1
JSON格式
{ "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368", "InstanceId": "i-instance1"}
所属专题: