阿里云创建实例接口参数有哪些

 
阿里云创建实例接口参数有哪些
2016-09-15 07:04:30 /故事大全

创建实例

描述

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

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

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

一个实例创建时必须指定加入一个安全组。安全组需要预先创建,可通过 创建安全组 接口创建,可以在新创建实例时指定,也可通过 修改实例属性 的接口来完成实例所属安全组变更。在同一个安全组内的实例内网可以相互访问,但不同安全组之间默认有防火墙隔离,不可相互访问,但可通过安全组授权(通过授权安全组权限接口实现)来设置此安全组的防火墙权限。同一个安全组内的实例数量不能超过 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"}

所属专题:
如果您觉得本文或图片不错,请把它分享给您的朋友吧!

 
故事大全
 
版权所有- © 2012-2015 · 故事大全 SITEMAP站点地图手机看故事 站点地图