586      阿里云  技术社区[云栖]

创建实例__实例相关接口_API 参考_云服务器 ECS-阿里云

描述

创建实例需要通过实名认证。没有通过实名认证的可以前往 阿里云官网 中的用户中心—>会员信息中进行实名认证。

根据传入参数创建弹性计算实例。

• 在创建实例时，必须要选择镜像，用来确定新创建实例的系统盘配置。镜像包含操作系统以及应用软件配置，基于镜像创建实例后，实例的系统盘即为此镜像的完全克隆。

• 一个实例创建时必须指定加入一个安全组。安全组需要预先创建，可通过创建安全组接口创建，可以在新创建实例时指定，也可通过 修改实例属性 的接口来完成实例所属安全组变更。在同一个安全组内的实例内网可以相互访问，但不同安全组之间默认有防火墙隔离，不可相互访问，但可通过安全组授权（通过授权安全组权限接口实现）来设置此安全组的防火墙权限。同一个安全组内的实例数量不能超过1000个，若组内实例数量超出限制，创建实例时若指定该安全组，会提示失败。

• 在创建实例时，如果参数InternetChargeType的值设置为PayByBandwidth（按固定带宽付费），则InternetMaxBandwidthOut的设置值即为所选的固定带宽值；如果参数InternetChargeType的值设置为PayByTraffic（按流量付费），则InternetMaxBandwidthOut只是一个带宽的上限设置，计费以发生的网络流量为依据。设置InternetChargeType和InternetMaxBandwidthOut时，应仔细核算可能发生的带宽费用。

• InternetMaxBandwidthIn的值在任何情况下都与计费无关，实例的入数据流量是免费的。

• 创建实例时，可以选择是否为IO优化实例（IoOptimized）。

• 实例创建时，系统会根据用户所指定镜像为实例分配一个相应大小的系统盘,系统盘容量=Max{40,ImageSize}；也可以指定系统盘的容量SystemDisk.size参数，该参数必须大于等于max{40,ImageSize};同时，可以指定系统盘的种类：普通云盘（cloud）、高效云盘（cloud_efficiency）、SSD云盘（cloud_ssd）、本地 SSD 盘（ephemeral_ssd）。

• 当实例选择为IO优化实例时，系统盘只能选择高效云盘（cloud_efficiency）及SSD云盘（cloud_ssd）

• ECS不支持单独创建或者添加本地SSD盘，因此本地SSD盘必须在创建实例时指定，实例创建完成后不能再添加。各个实例规格对不同磁盘种类大小的限制见 实例资源规格对照表。

• 单块普通云盘（cloud）容量最大不能超过2000GB，单块高效云盘（cloud_efficiency）容量最大不超过32TB（32768GB），单块SSD云盘（cloud_ssd）容量最大不能超过32TB（32768GB），单块本地 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。

• 一个实例最多添加4块数据盘；数据盘选择本地 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。

• 若实例付费类型为预付费的包年包月实例（PrePaid）,则在执行付款时默认会使用该账号下可用的优惠券（0折账号除外）

• 创建完成后，实例为 Stopped 状态

• 在阿里云CLI及SDK中使用该API时，部分带”.”号的入参需要去掉”.”号使用，包括：SystemDisk.Category、SystemDisk.Size、SystemDisk.Description、DataDisk.n.Size、DataDisk.n.Category、DataDisk.n.SnapshotId、DataDisk.n.DiskName、DataDisk.n.Description、DataDisk.n.Device、DataDisk.n.DeleteWithInstance。如：在阿里云CLI及SDK中使用SystemDiskCategory来表示SystemDisk.Category入参

请求参数

返回参数

错误码

示例

请求示例

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格式

<CreateInstanceResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <InstanceId>i-instance1</InstanceId>
</CreateInstanceResponse>

JSON格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "InstanceId": "i-instance1"
}

最后更新：2016-11-23 16:03:50

  上一篇： ECS API 发生子账号访问主账号资源时的鉴权规则__借助 RAM 实现子账号对主账号的 ECS 资源访问_API 参考_云服务器 ECS-阿里云

  下一篇： 启动实例__实例相关接口_API 参考_云服务器 ECS-阿里云