京东云服务器购买方式

购买一台或多台指定配置的京东云服务器，购买模式分为三种：1.普通方式、2.使用高可用组、3.使用启动模板。三种方式购买京东云服务器时参数的必传与非必传是不同的，具体请参考参数详细说明

购买京东云服务器需要通过实名认证京东云服务器规格可查询DescribeInstanceTypes接口获得指定地域或可用区的规格信息。不能使用已下线、或已售馨的规格ID镜像Windows Server所有镜像CPU不可选超过64核CPU。可查询DescribeImages接口获得指定地域的镜像信息。选择的镜像必须支持选择的京东云服务器规格。可查询DescribeImageConstraints接口获得指定镜像的京东云服务器规格限制信息。
网络配置指定主网卡配置信息必须指定subnetId可以指定elasticIp规格来约束购买的弹性IP，带宽取值范围[1-200]Mbps，步进1Mbps可以指定主网卡的内网主IP(primaryIpAddress)，此时maxCount只能为1安全组securityGroup需与子网Subnet在同一个私有网络VPC内一台京东云服务器购买时必须至少指定一个安全组，至多指定5个安全组，如果没有指定安全组，默认使用默认安全组主网卡deviceIndex设置为1存储系统盘磁盘分类，系统盘支持local或cloud磁盘大小local：不能指定大小，默认为40GBcloud：取值范围: 40-500GB，并且不能小于镜像的最小系统盘大小，如果没有指定，默认以镜像中的系统盘大小为准自动删除如果是local类型，默认自动删除，不可修改如果是cloud类型的按配置计费的云硬盘，默认为True，可修改如果是cloud类型的包年包月的云硬盘，默认为False，不可修改数据盘磁盘分类，数据盘仅支持cloud云硬盘类型可以选择ssd、premium-hdd、hdd.std1、ssd.gp1、ssd.io1磁盘大小premium-hdd：范围[20,3000]GB，步长为10Gssd：范围[20,1000]GB，步长为10Ghdd.std1、ssd.gp1、ssd.io1: 范围[20-16000]GB，步长为10GB自动删除默认自动删除，如果是包年包月的云硬盘，此参数不生效可以从快照购买磁盘local类型系统的京东云服务器可以挂载8块云硬盘cloud类型系统的京东云服务器可以挂载7块云硬盘计费弹性IP的计费模式，如果选择按用量类型可以单独设置，其它计费模式都以主机为准云硬盘的计费模式以主机为准其他购买完成后，主机状态为running仅Linux系统京东云服务器可以指定密钥maxCount为最大努力，不保证一定能达到maxCount虚机的az会覆盖磁盘的az属性密码参考公共参数规范请求方式

名称类型是否必需默认值描述regionIdStringTrue地域ID请求参数名称类型是否必需默认值描述instanceSpecInstanceSpecTrue描述京东云服务器配置
maxCountIntegerFalse1购买京东云服务器的数量；取值范围：[1,100]，默认为1。
clientTokenStringFalse用于保证请求的幂等性。由客户端生成，长度不能超过64个字符。
InstanceSpec名称类型是否必需默认值描述agIdStringFalse高可用组Id。指定了此参数后，只能通过高可用组关联的京东云服务器模板购买虚机，并且京东云服务器模板中的参数不可覆盖替换。京东云服务器模板以外的参数还可以指定。instanceTemplateIdStringFalse京东云服务器模板id，如果没有使用高可用组，那么对于京东云服务器模板中没有的信息，需要使用购买虚机的参数进行补充，或者选择覆盖启动模板中的参数。azStringFalse京东云服务器所属的可用区。instanceTypeStringFalse京东云服务器规格。可查询DescribeInstanceTypes接口获得指定地域或可用区的规格信息。imageIdStringFalse镜像ID。可查询DescribeImages接口获得指定地域的镜像信息。nameStringTrue京东云服务器名称，参考公共参数规范。passwordStringFalse密码，参考公共参数规范。keyNamesString[ ]False密钥对名称，当前只支持传入一个。elasticIpElasticIpSpecFalse主网卡主IP关联的弹性IP规格primaryNetworkInterfaceInstanceNetworkInterfaceAttachmentSpecFalse主网卡配置信息systemDiskInstanceDiskAttachmentSpecFalse系统盘配置信息dataDisksInstanceDiskAttachmentSpec[ ]False数据盘配置信息，本地盘(local类型)做系统盘的京东云服务器可挂载8块数据盘，云硬盘(cloud类型)做系统盘的京东云服务器可挂载7块数据盘。chargeChargeSpecFalse计费配置
京东云服务器不支持按用量方式计费，默认为按配置计费。
打包购买数据盘的情况下，数据盘的计费方式只能与京东云服务器保持一致。
打包购买弹性公网IP的情况下，若公网IP的计费方式没有指定为按用量计费，那么公网IP计费方式只能与京东云服务器保持一致。
userdataUserdata[ ]False元数据信息，目前只支持传入一个key为"launch-script"，表示首次启动脚本。value为base64格式。
launch-script：linux系统支持bash和python，编码前须分别以 #!/bin/bash 和 #!/usr/bin/env python 作为内容首行;
launch-script：windows系统支持bat和powershell，编码前须分别以 和 作为内容首、尾行。
descriptionStringFalse主机描述，参考公共参数规范。noPasswordBooleanFalse不使用模板中的密码。
仅当不使用Ag，并且使用了模板，并且password参数为空时，此参数(值为true)生效。
若使用模板购买虚机时，又指定了password参数时，此参数无效，以新指定的为准。
noKeyNamesBooleanFalse不使用模板中的密钥。
仅当不使用Ag，并且使用了模板，并且keynames参数为空时，此参数(值为true)生效。
若使用模板购买虚机时，又指定了keynames参数时，此参数无效，以新指定的为准。
noElasticIpBooleanFalse不使用模板中的弹性公网IP。
仅当不使用Ag，并且使用了模板，并且elasticIp参数为空时，此参数(值为true)生效。
若使用模板购买虚机时，又指定了elasticIp参数时，此参数无效，以新指定的为准。Userdata名称类型是否必需默认值描述keyStringFalse键valueStringFalse值ChargeSpec名称类型是否必需默认值描述chargeModeStringFalsepostpaid_by_duration计费模式，取值为：prepaid_by_duration，postpaid_by_usage或postpaid_by_duration，prepaid_by_duration表示预付费，postpaid_by_usage表示按用量后付费，postpaid_by_duration表示按配置后付费，默认为postpaid_by_duration.请参阅具体产品线帮助文档确认该产品线支持的计费类型chargeUnitStringFalse预付费计费单位，预付费必填，当chargeMode为prepaid_by_duration时有效，取值为：month、year，默认为monthchargeDurationIntegerFalse预付费计费时长，预付费必填，当chargeMode取值为prepaid_by_duration时有效。当chargeUnit为month时取值为：1~9，当chargeUnit为year时取值为：1、2、3autoRenewbooleanFalsefalsetrue为开通自动续费，false为不开通自动续费，仅对包年包月资源有效，如一同购买了云硬盘和公网IP将一并进行设置。开通后，将以本次购买时的购买时长作为自动续费周期，自动续费周期可在续费管理功能中进行修改。InstanceDiskAttachmentSpec名称类型是否必需默认值描述diskCategoryStringFalse磁盘分类，取值为本地盘(local)或者云硬盘(cloud)。
系统盘支持本地盘(local)或者云硬盘(cloud)。系统盘选择local类型，必须使用localDisk类型的镜像；同理系统盘选择cloud类型，必须使用cloudDisk类型的镜像。
数据盘仅支持云硬盘(cloud)。
autoDeleteBooleanFalse是否随京东云服务器一起删除，即删除主机时是否自动删除此磁盘，默认为true，本地盘(local)不能更改此值。
如果京东云服务器中的数据盘(cloud)是包年包月计费方式，此参数不生效。
如果京东云服务器中的数据盘(cloud)是共享型数据盘，此参数不生效。
cloudDiskSpecDiskSpecFalse数据盘配置deviceNameStringFalse数据盘逻辑挂载点，取值范围：vda,vdb,vdc,vdd,vde,vdf,vdg,vdh,vdi,vmj,vdk,vdl,vdmnoDeviceBooleanFalse排除设备，使用此参数noDevice配合deviceName一起使用。
购买整机镜像：如deviceName:vdb、noDevice:true，则表示京东云服务器中的数据盘vdb不参与购买镜像。
购买模板：如deviceName:vdb、noDevice:true，则表示镜像中的数据盘vdb不参与购买主机。
购买主机：如deviceName:vdb、noDevice:true，则表示镜像中的数据盘vdb，或者模板(使用模板购买主机)中的数据盘vdb不参与购买主机。
DiskSpec名称类型是否必需默认值描述azStringTrue云硬盘所属的可用区nameStringTrue云硬盘名称descriptionStringFalse云硬盘描述diskTypeStringTrue云硬盘类型，取值为ssd、premium-hdd、ssd.gp1、ssd.io1、hdd.std1之一diskSizeGBIntegerTrue云硬盘大小，单位为 GiB，ssd 类型取值范围[20,1000]GB，步长为10G，premium-hdd 类型取值范围[20,3000]GB，步长为10G, ssd.gp1, ssd.io1, hdd.std1 类型取值均是范围[20,16000]GB，步长为10GiopsIntegerFalse云硬盘IOPS的大小，当且仅当云盘类型是ssd.io1型的云盘有效，步长是10.snapshotIdStringFalse用于购买云硬盘的快照IDchargeChargeSpecFalse计费配置；如不指定，默认计费类型是后付费-按使用时常付费multiAttachableBooleanFalse云硬盘是否支持一盘多主机挂载，默认为false（不支持）encryptBooleanFalse云硬盘是否加密，默认为false（不加密）InstanceNetworkInterfaceAttachmentSpec名称类型是否必需默认值描述deviceIndexIntegerFalse网卡设备Index，主网卡只能是1networkInterfaceNetworkInterfaceSpecFalse网卡接口规范NetworkInterfaceSpec名称类型是否必需默认值描述subnetIdStringTrue子网IDazStringFalse可用区，用户的默认可用区，该参数无效，不建议使用networkInterfaceNameStringFalse网卡名称，只允许输入中文、数字、大小写字母、英文下划线“_”及中划线“-”，不允许为空且不超过32字符。primaryIpAddressStringFalse网卡主IP，如果不指定，会自动从子网中分配secondaryIpAddressesString[ ]FalseSecondaryIp列表secondaryIpCountIntegerFalse自动分配的SecondaryIp数量securityGroupsString[ ]False要绑定的安全组ID列表，最多指定5个安全组sanityCheckIntegerFalse源和目标IP地址校验，取值为0或者1,默认为1descriptionStringFalse描述,? 允许输入UTF-8编码下的全部字符，不超过256字符ElasticIpSpec名称类型是否必需默认值描述bandwidthMbpsIntegerTrue弹性公网IP的限速（单位：Mbps），取值范围为[1-200]providerStringTrueIP服务商，取值为bgp或no_bgp，cn-north-1：bgp；cn-south-1：[bgp，no_bgp]；cn-east-1：[bgp，no_bgp]；cn-east-2：bgpchargeSpecChargeSpecFalse计费配置返回参数名称类型描述resultResultrequestIdStringResult名称类型描述instanceIdsString[ ]返回码返回码描述200OK400Invalid parameter401Authentication failed404Not found429Quota exceeded500Internal server error503Service unavailable